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ASTRQ PI IS EN ROUTE TO THE INTERNATIONAL SPACE STATION 




Expand your Pi 

Stackable expansion boards for the Raspberry Pi 


Serial Pi Plus 

RS232 serial communication board. 
Control your Raspberry Pi over RS232 
or connect to external serial 
accessories. 

Breakout Pi Plus 

The Breakout Pi Plus is a useful 
and versatile prototyping expansion 
board for the Raspberry Pi 


ADC Differential Pi 

8 channel 18 bit analogue to digital 
converter. PC address selection 
allows you to add up to 32 analogue 
inputs to your Raspberry Pi. 


lO Pi Plus 

32 digital 5V inputs or outputs. PC 
address selection allows you to stack 
up to 4 lO Pi Plus boards on your 
Raspberry Pi giving you 128 digital 
inputs or outputs. 

RTC Pi Plus 

Real-time clock with battery backup 
and 5V PC level converter for adding 
external 5V PC devices to your 
Raspberry Pi. 


1 Wire Pi Plus 

1-Wire® to PC host interface with ESD 
protection diode and PC address 
selection. 



electronics uk 


We also stock a wide range of expansion boards 
for the originai Raspberry Pi modeis A and B 



www.abelectronics.co.uk 
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RASPBERRY PI ZERO: 
ACCESS TO TOOLS 


® y first computer, a second-hand BBC Micro 
with its built-in BASIC, cost me £220 in 
1989. That’s £500 in today’s money. My 
Amiga was a little cheaper, costing £200 in 1993, 
but I had to save for three more months to buy the 
software and documentation I needed to program it. 
Throughout my childhood, cost limited my access 
to the tools I needed to learn. This is why, of all the 
work that we do at Raspberry Pi, driving down the 
cost of computing is the single thing that matters 
most to me. 

The original Raspberry Pi Model B and its 
successors put a programmable computer within 
reach of anyone with $20-35 to spend. Now we’re 
taking the next step: in Raspberry Pi Zero, we finally 
have a computer we can sell for $5, or give away on 
the front of a magazine. 

We all need access to tools. Cost should never be a 
barrier. Enjoy your Raspberry Pi Zero. 



THIS MONTH: 



8 INTRODUCING THE TINY $5 PI ZERO 

Find out what the Zero is and what you can do with it 

16 SET UP YOUR FREE RASPBERRY PI 

Find out which cables you need and how to set it up 

70 ASTRO PI: WE ARE GO FOR LAUNCH! 

The Raspberry Pi is going to space with some ofvour projects 

76 GET STARTED WITH THE SENSE HAT 

Want to share in the excitement of Astro Pi? Flere's how... 
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raspberrypi.org/magpi 
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TUTORIALS 


> PIPE TEMPERATURE MONITOR 50 

Join Dr Simon Monk for more Everyday Engineering using 
the Raspberry Pi and avoid frozen pipes this winter 


> TRAFEIC HAT WITH GPIO ZERO 54 

The affordable Traffic HAT showcases GPIO Zero's talents 


> MIKE'S PI BAKERY: 3D IMAGES 56 

Build your own 3D image viewer with the help of Raspberry 
Pi hacker extraordinaire. Mike Cook 


> SONIG PI: MUSIGAL MINEGRAFT 60 

Make much more than just music with the aid of Sam Aaron 


> GAMES WITH PYTHON: PART 10 62 

In this final instalment we add some extra features and 
polish to our space shooter game written in Python 



CODE CLUB JOINS 
THE FOUNDATION 


The Raspberry Pi Foundation and 
Code Club have merged to further 
theirjoint goal of righting past wrongs 


THIS MONTH IN 
RASPBERRY PI 

Join us for a new regular feature 
that looks at what’s going on in 
the Raspberry Pi community in 
the past 30 days 


4 


December 2015 


raspberrypi.org/magpi 












Contents 


THE FINAL WORD 


Matt Richardson talks about Pi Zero, the tiny 
computer with a big impact... 
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This Pi-powered paraLLeL processing sculpture wiLL take your breath away 


MAGIC MIRROR 44 

Take a long look in the mirror. You need to shape 
up if you want to build a project of this quality! 
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We speak to Raspberry Pi and Code Club bosses 
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Find a community gathering near you in the coming weeks 
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Has this Raspberry Pi Laptop delivered on its promise? 
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We Look atTenma's new adjustable soldering iron 
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The best computing reads evaluated for your pleasure 
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£ 12.99 




200 pages of 

Raspberry Pi 


RASPBERRY PI 

PROJECTS BOOK 


Amazing hacking and making projects 

from the makers of magazine 


Inside: 


# How to get started with Raspberry Pi 

# The most inspirational community projects 

# Essential tutorials, guides and ideas 

# Expert reviews and buying advice 


^ noti) 


SWAG.RASPBERRYPLORG 

and from all good newsagents 


Availab e on the 

App Store 




Get it on 

Google play 
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RASPBERRY PI 



eM like you to pick up 
the Raspberry Pi Zero 
that came with 
this very magazine. 

Youhe holding 
in your hands a ^ 

fully functional • 

computer that’s • 

going on sale for $5 • 

to 

and that you could lose * 
in a small purse. It’s • 

quite the amazing feat . 

of engineering and we’re < 

very excited to bring it to 
our readers, along with 32 
pages of content that will 
take you from a Zero Novice to a 
Zero Master. 

Over the course of our expansive 
coverage, we talk to the people 
behind the Raspberry Pi Zero’s 
development, teach you how to 
hook it up, and also suggest some 
great uses for your Zero. With 
its even smaller size, there are 
some amazing things you’ll be 
able to do with it. Check out the 
contents on the facing page to jump 
to what interests you, and just have 
a good time with your new Pi Zero. 


Mini-HDMI port 
for digital sound 
and io8op video 


Broadcom BCM 
2835 system - 
on-a-chip, the 
same chip 
that powered 
the original 
Raspberry Pi 


slot for storing 
the operating 
system, files, 
and documents 
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RASPBERRY PI ZERO 



40-pin 

unpopulated 
GPIO port for 
connecting to 
your electronic 
circuits 


Unpopulated 
RUN mode pins 
which can be 
used to add a 
reset button to 
the Pi Zero 


Unpopulated 
RCA composite 
video out pins so 
you can connect 
to an old TV 



Power and 
activity LED - this 
lets you know the 
Pi Zero is on and 
working away 


Micro-USB port 
for power - the 
same kind that 
charges Android 
mobile phones 


Micro USB port 
for connecting to 
keyboards, mice, 
WiFi, USB sticks, 
and more 


THE SPECS 


CPU: BCM 2835 (same as the original 
Raspberry Pi), iGHz single core ARMii 

RAM: 512MB 

Storage: Via microSD 

Power: Micro-USB connector 

Video out: Mini-HDMl 

Connectivity: ix micro-USB, unpopulated 40-pin GPIO 
connector, unpopulated Composite Video Out 

Dimensions: 65mm x 30mm x 5mm Weight: pg 


CONTENTS 

SIZE MAHERS 

How big is a Pi Zero? We’ve been 
comparing them to all sorts of things... 
>10 

THE STORY OF ZERO 


We talk to Eben Upton and Mike 
Stimson about Zero’s development 
>12 


SET UP YOUR PI ZERO 

Learn how to get your Pi Zero 
hooked up 
>16 

HOW IS THE PI ZERO? 


A quick tour around the Raspberry Pi 
Zero and the operating system 
>18 

ESSENTIAL TIPS 


Learn five techniques that will make 
using Pi Zero much easier 
>20 

QUICK PROJECTS 

Some quick taster projects that 
improve traditional Raspberry Pi uses 
>22 

SOLOERAGPIO PORT 


Want to access the GPIO pins? Here’s 
our guide to soldering them on 
>23 

ZERO PROJECTS 


Get started straight away with your Pi 
Zero with these great projects 
>24 

30 PRINTEO CASE 


Learn how to 3D print your own custom 
MagPi case for your new Pi Zero 
>41 
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PI ZERO IN PICTURES 



IN PICTURES 


Send us your best comparison shots on Twitter to @TheMagPi 



RASPBERRY PI 

ZER0 
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RASPBERRY PI ZERO 
IN NUMBERS 


RASPBERRY PI ZERO 


The Raspberry Pi Zero is the first ever But it’s nearly three times smaller than 
full computer that costs only $5 the original Raspberry Pi 


A LEGO Minifigure is just a bit taller than the Zero is wide. 
It’s about one Minifigure wide and under two Minifigures long. 
Also, they can easily carry one! 


It’s so small, you 
could lay 143 
Raspberry Pi Zeros 
over the screen of 
a 32" HD TV! 


A classic, 
we’re working 
on making a fully 
working Pi Zero 
- battery and 
everything - in an 
Altoids mint tin. You 
can fit six in one! 


That’s lOOGB of RAM with 200 computing cores in a single 
box of Pi Zeros. The box only weighs 2.5kg 


Putting 
a Raspberry Pi 
Zero in a pack of 
cards sounds like 
proper James Bond 
territory, although 
you’d lose the 
cards you need to 
play poker 


It also launches 
with twice as 
much RAM as 
the very first 
Raspberry Pi did 
(it 256MB) 


512MB 

IGOmA 


Hooked up to a lOSop TV with a mouse and keyboard attached, the Pi Zero 
draws a tiny 160mA. The electricity bill will be the last thing on your mind! 
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INTERVIEW 


WHEN WE LAUNCHED 

RASPBERRY PI, 

WE CHANGED THE 
PRICE OF THIS KIND 

OF HARDWARE... 

WITH THE ZERO, 
WE WANTED TO 

DO IT AGAIN 



INTERVIEW 


EBEN UPTON MIKE STIMSON 


CEO, RASPBERRY PI TRADING 


The co-creator of the Raspberry Pi, Eben is the 
original mind behind the miniature Raspberry Pi 
Zero as well 


PRINCIPAL HARDWARE ENGINEER 


The designer behind the Raspberry Pi Zero, 
Mike has been with Raspberry Pi for less 
than a year 
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The start 
of the Raspberry 
Pi Zero’s life on a 
scrap of paper 


I had a really interesting 
I conversation with Eric 
Schmidt [CEO of Google]/’ 
Eben Upton, CEO of Raspberry 
Pi Trading, recounts to us over 
a Skype chat one rainy morning 
in late October. 


expensive, and at the time we 
had a potential route to make this 
Pi 2 much more powerful... He 
said ‘don’t be an idiot. That’s a 
ridiculous idea. You have to try and 
be as close to free as possible... 
it’s very hard to compete with 


He said 'don't be an idiot. That's 
a ridiculous idea. You have to try 
and be as close to free as possible' 


In 2013, Eben met Eric after Google 
announced it would give $1 million 
to the Raspberry Pi Foundation to 
provide Pis to schoolkids. “[Eric] was 
there for the announcement. 1 had a 
great chat with him and it was one of 
those 45-second chats that changes 
your life. 

“1 was telling him that we were 
thinking of doing a Raspberry 
Pi 2 that was going to be more 


cheap; it’s very hard to compete 
with free’.” 

Eben went back to the office 
and cancelled all the engineering 
they had been planning for 
the Raspberry Pi 2. This was 
in 2013, and the cancellation 
delayed its release until February 
2015, allowing the Raspberry Pi 
Foundation to retail the Pi 2 for 
$35. This wasn’t the only outcome 


from Eben’s conversation with 
Eric, though: 

“The other thing was trying 
to look at what we could do to go 
lower than $25.” 

The first result of this new 
outlook was selling the Pi Model 
A+ for $20, but after drastically 
changing the standard price of 
microcomputers in 2012 by a factor 
of five, Eben wanted to do it again. 
This meant a computer retailing 
for only $5. 

“I’d heard conversations about 
doing something very small, very 
cheap,” Mike Stimson, principal 
hardware engineer and the 
designer of the Raspberry Pi Zero, 
tells us. He joined in January 2015 
as the Raspberry Pi 2 project was 
ramping down. The planning for 
the Raspberry Pi Zero had just 
begun, but Mike hadn’t begun 
working on it at that early stage. 
When it was finally pitched to him 
at the beginning of the summer, it 
took him off guard. 
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INTERVIEW 
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THE 

DESIGN 

The first and final design, as 
created by Mike: ‘‘The biggest 
difference between the final 
and early version is obviously 
the height. When we looked 
at the layout, there seemed 
to be an awful lot of empty 
space - relatively speaking, 
of course.’’ 


FROM PI TO ZERO 



To take a Raspberry Pi 
Model A and make it as 
cheap and small as possible 


“It was strange actually,” recalls 
Mike. “I was in the middle of doing 
something else when someone 
came over and said that there was 
a new project: basically, to take a 
Raspberry Pi Model A and make it as 
cheap and small as possible [while 
still having the same specs]. Then 
we went through a list of features 
that we thought we could get rid of, 
ones we had to keep, and a few that 
we weren’t quite sure about.” 

“There was enthusiasm. And 
scepticism,” Eben laughs as he 
recalls the original pitch meeting. 
“You’ve got a room full of the 
brightest guys on the planet, right, 
and you say ‘hey, we’re going to do 
this and it’s going to have a business 
model that looks a bit like this. 

It’s going to be great!’ Scepticism, 
obviously, but also enthusiasm. 
Enthusiasm that if we can pull it 
off, then we’ve managed to do again 
what we did before.” 

“I think my natural reaction 
to all these things is that it’s all 
crazy talk,” Mike says of the pitch. 
“I’ve learnt to doubt my own first 


instincts when it comes to these 
kinds of things, though.” 

The first prototype was turned 
around pretty quickly once Mike 
got on to actually designing the Pi 
Zero. However, that didn’t mean it 
was easy. 

“Originally, we were talking about 
something in the region of 35mm 
wide and the same length as the 
A+,” Mike explains to us. “It looked 
challenging because the other thing 
we also wanted to do to keep costs 
down was to make it single side 
assembly. Not only is it considerably 
smaller than an A+, it’s a lot more 
dense component-wise on that 
top layer. There’s a lot more clever 
routing that has to be done in order 
to get that size down. 

“I made it to about 65 by 35mm 
and then we looked at it and thought 
we could probably shave off a few 
more millimetres. So we rearranged 
a few of the connectors and we got 
it to the 30mm-wide crazy size 
it is now.” 

Once the design was complete and 
Raspberry Pi was happy with the 
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INDUSTRIAL PI 



A couple of months or so 
later, people begin receiving 
their Raspberry Pis. Based on 
Debian Linux, the new Raspbian 
operating system is released for 
the Raspberry Pi and adopted as 
the recommended OS. 


Manufacturing of Raspberry 
Pis moves to factories in Wales 
managed by Sony, bringing the 
Raspberry Pi home to be a fully 
British computer. 


At 6:00 GMT the original 
Raspberry Pi goes on sale, selling 
out within minutes. It is one of 
the top-read stories on the BBC 
website, and over 100,000 pre- 
orders are made in the first day. 


The Compute Module Raspberry 
Pi is released, a miniature 
Raspberry Pi on a SODIMM 
laptop memory-style circuit 
board, that can be used to bring 
Pi power to any device. 
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WHAT IS THE 

RCA VIDEO OUT 

CONNECTOR FOR? 


"The final product has the 
composite signal brought out 
to a 0.1 inch pad. so if you want 
to solder an RCA cable onto it 
you can. 

"We’re psyched about the 
idea of people being able to 
take it and solder it inside an old 
television - you know, get an old 
television and crack it open. Turn 
your television into a computer. 
We think that’s really good for 
developing world applications.’’ 


prototypes, they began the process 
of making sure there would be 
enough Raspberry Pi Zeros available 
for launch. 

“We spent a couple of months, 
June and July, getting manufacturing 
quotes. We were very pleased to 
see that UK manufacturing was 
very competitive. It was by far 
the cheapest way of making it. 

Then we committed orders in 
August and manufacturing started 
[on] 27 October - mass volume 
manufacturing. The first 10,000 are 
for The MagPi, so the Pi Zero you hold 
in your hand may very well be being 
manufactured as I speak.’’ 


From inception in January to 
people’s hands in November, 
the Raspberry Pi Zero didn’t take 
very long at all, especially when 
you compare it to six years for 
the original Pi and over two years 
for the Pi 2. 

“It’s quite fast for us; it’s being 
helped by the fact it is a real 
Raspberry Pi,” Eben tells us. “So 
there’s no significant software 
engineering involved in doing it... 
it is quite an aggressive schedule, 
but it’s good!” 

Commenting on the final 
product, both Eben and Mike seem 
very pleased with it, both in terms 
of the technological feat they’ve 
accomplished and the aesthetics 
of the Pi Zero as well. 

“I just hope people like it,” 

Eben says. “I hope that it helps 
the education mission a lot. It’s 
great to make computers and 
stuff, but all the money is going 
back into the charity, so we kind 
of hope that the existence of this 
cheap thing will let even more 
people in the door. And maybe 
that’s not even people in the UK 
any more, but also people in the 
developing world. 

“Having cheap, open, general- 
purpose computing - that’s got 
to be good for something. We’re 
building look of them at first, but 
I’m just hoping it will have a life 
after that.” 


ON THE COVER 


We’re the first ever magazine in the world to give away 
a real computer on the cover. Here are some other 
notable covermount firsts through the years. . . 


19608 SATIRE ON RECORD 

Some issues of satirical magazine Private Eye would 
have covermounted floppy 7" vinyls which had 
comedy recordings on them. In classic Private Eye 
style, they all had punny titles which we won't subject , 
you to here. 




1970S FLEXI-DISC MUSIC 

With the popularisation of these 'flexi-discs' on covers, 
pop music mags began mounting samples and songs 
on the front of their covers. NME did this a lot in the 
Seventies with plenty of rock vinyls. 

19808 new hardware 

As computer magazines took off. so did shareware 
software attached to the front. It started with floppy 
disks, but as CDs became much cheaper, magazine 
covers began appearing with data CDs on the cover. 

1990S DEMO DISCS 

When video games moved to discs with the advent of 
CD-ROM drives and the PlayStation, cover discs with 
game demos were big business. 


2000s DVDS FOR ALL 

As prices for optical media fell, any magazine with an idea 
for disc content would have a covermounted DVD. Film 
trailers, software, art assets, commentary, instructional 
videos, and much more made their way to magazine 
covers the world over. 

”2015 A COMPUTER ON THE COVER 

The MagPi is the first magazine to give you hardware 1 

on its cover. The Raspberry Pi Zero is the world's first j 
covermounted computer - it's never been done before, j 
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^PIZERO 


A BEHER 10 A CHEAPER Of ANEW 20 pROM ZERO 

2014 RASPBERRY PI 2014 RASPBERRY PI 2015 RASPBERRY PI 2015 TO HERO 


The Raspberry Pi B+ is The Raspberry Pi A+ is announced. The Raspberry Pi 2 is announced. The Zero is launched, with the first 

announced by the Foundation, a a much smaller version of the completely shocking the lo.ooo units being stuck to the 

redesign of the Raspberry Pi that Raspberry Pi Model A that is also community. With much improved front of The MagPi in newsagents 

contains more USB ports and a even cheaper at $20. Much like power and memory, the across the UK. It’s a $5 computer 

better layout of its components. the B+. there are no changes in Raspberry Pi finally reaches its that will hopefully further change 

The form factor will lead the way the spec, although it does lose full potential and leads to better the computing landscape. 


for the Raspberry Pi. one of its output ports. making and educating. 



raspberrypi.org/magpi 


December 2015 


15 



ZERO UNBOXED 


Let’s take a 
closer look at 
this miniature 
Raspberry Pi 
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RASPBERRY PI ZERO 



ASSEMBLE 
YOUR ZERO 

It’s simple enough to put your Raspberry Pi 
Zero together - as easy as i, 2, 3, in fact... 

>STEP ONE 

PLUG IN SD CARD 

You’ll need to install NOOBS 
(New Out Of Box Software) onto 
your Raspberry Pi Zero, enabling 
you to choose an operating 
system. Plug your microSD card 
into another computer and visit 
the Raspberry Pi download site 
(magpi.cc/iMYYTMo). Download 
the NOOBS zip file and unzip it onto 
the SD card to install it. Once that’s 
done, slot it in. 



GRAB YOUR 
CABLES 


Don’t have a mini- 
HDMI or micro-USB 
converter? We’ve 
got you covered... 


We understand the cables 
required to get your Raspberry 
Pi Zero hooked up are not 
particularly common; although 
you might have a mini-HDMI 
cable if you bought a really nice 
camera in the last few years, the 
micro-USB adaptors are much 
less common. With that in mind, 
Raspberry Pi has put together a 
cable bundle that will help you 
get your Zero working in no time. 
Just head over to the Swag Store 
(swaq.raspberrypi.orq) to get a 
bundle today! 


These two 
special cables 
allow the Pi Zero to 
be teeny-tiny 








>STEP TWO 

CONNECT CABLES 

Plug in the mini-HDMI to HDMI 
connector and make sure it’s 
properly connected between the 
Raspberry Pi Zero and your display. 
Now plug in your USB adaptor, 
making sure it’s in the correct 
micro-USB port, and attach your 
USB hub. You may not need a hub 
with external power, but make sure 
one is handy just in case. 


>STEP THREE 

POWER IT UP 


Plug the power cable into the 
micro-USB power socket, again 
checking to make sure it’s the correct 
one - at this point it should be the 
only one left. Plugging the other end 
of the power supply into a wall socket 
will immediately turn the Raspberry 
Pi Zero on. You’re now ready to start a 
new chapter in hacking and making! 


RASPBERRY PI 

ZERO 
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GET TO KNOW RASPBIAN 


GET TO KNOW 

PI ZERO 


Run commands the 


TheRaspbian 

interface should be 
familiar to almost 
anyone who has 
used computers 


All the programs in 
Raspbian are kept 
in the program 
menu. All the 
software available 
on the original Pi 
and Pi 2 are still 
here for Zero 


Start or continue 
to learn to code 
with the excellent 
resources available 



old-fashioned way 
in the terminal or 
via the command- 
line interface, 
on the Pi Zero or 
remotely over 
the network 


Browse the internet 
on the Pi Zero if you 
connect a wireless 
dongle, making 
for a great low- 
profile web kiosk 
or smart TV 



MORE COMPONENTS FOR YOUR ZERO 


ETHERNET ADAPTOR 

While Raspbian and the Pi Zero work just fine with 
WiFi, if you want a slightly more stable connection, you 
might want to try a USB Ethernet adaptor. There are 
a few around, and we Ve even heard rumours of some 
that plug straight into micro-USB ports; however, youTl 
have more luck finding one that will 
plug into a micro-USB to USB 
adaptor, or straight into 
a USB hub. "S' 


CASE 

The Pi Zero is a sensitive electronic device, so 
it's probably best to not have it just on a table 
gathering dust. At the time of writing, ^ 
there aren't any cases just yet for the 
Raspberry Pi Zero, but they'll soon 
come. For the moment, we suggest 
you head over to page 41 to find out 
how you can 3D-print your own 
custom Pi Zero keyring case. 
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THE RASPBERRY PI ZERO 


ow you Ve got your Pi Zero 

IM hooked up, using it with 
Raspbian should feel very 
familiar. That’s because the OS 
works in exactly the same way as it 
does on any other Raspberry Pi. 

This shouldn’t come as any 
surprise really if you’ve been 
following the story so far. On 
the other hand, you’ll be in for a 
bit of a shock if you’ve become 
used to the extra speed that the 
Raspberry Pi 2 offers you. Going 
back to original Raspberry Pi speeds 
really highlights how much more 
powerful the 2 is; however, the 
Raspberry Pi Zero is also the size 
of a large thumb, so you’d expect 
some concessions. 

If this is your first time using a 
Raspberry Pi, then you’ll be looking 
around Raspbian for the first time 
too. As the operating system for 
the Raspberry Pi, it’s built quite 
simply to make it easy for people 
to use. It has a standard program 
menu (much like the Windows Start 
menu), where you access all your 
programs, and it has a lot of the 
standard pieces of software you’d 
need already installed. There’s a 
web browser, an email client, and 
office software called LibreOffice. 
They’re all optimised for use on 
the low-power Raspberry Pi, and 
even though there’s a much more 
powerful Raspberry Pi alternative, 
they all work absolutely fine on the 
Raspberry Pi Zero. 

LibreOffice especially was a 
concern as it’s a very new piece 
of software for Raspbian, but it 


runs flawlessly on the Pi Zero 
without any performance issues. 
The rest of the basic software also 
works extremely well, although 
web browsing can get a little 
slow if you’re doing some really 
tab-heavy work. 

You can always overclock the Pi 
Zero to give it a bit more power. 

It’s not been fully tested, though, 
so you should probably use it 
sparingly. To find the controls for 
increasing the power of the CPU, 
select Preferences from the menu, 
then Raspberry Pi Configuration. 
You’ll find the Overclock option 
under the Performance tab. In the 
System tab, you’ll also find the 
option for whether or not to have 
the Pi start in the command-line 
or desktop. See our performance 
tests on this page to see if booting 
to command line would better for 
you: it would use less power (our 
initial tests have shown incredibly 
low power consumption) and 
you’d still be able to connect to it 
remotely via SSH. This low power 
usage and remote capabilities 
open the Zero up to be used for 
many purposes which we’ll cover 
throughout the rest of this feature. 

If you had any doubts, then, 
that the Raspberry Pi Zero would 
be a very stripped-back version of 
even the original Raspberry Pi, you 
have nothing to fear. At least on a 
software level, it will run the same 
code and programs in the same 
way with the same performance 
as before. It’s now just the size 
of a stick of gum. 



A good way to save USB space on a hub, there 
are plenty of good and cheap mini keyboard 
and mouse accessories that work great with 
the Raspberry Pi. It also means you can 
keep the Pi Zero hidden away in any 
little nook or cranny you can find 
and not have too many cables 
signifying its presence. 


WIRELESS KEYBOARD 
AND MOUSE COMBO 


NEED FOR SPEED 


We compared the boot time of the Raspberry Pi 
Zero to the Raspberry Pi 2. How does it fore? 

RASPBERRY PI 

Boot to command iine: 

Boot to desl(top: 

RASPBERRY PI ZERO 

Boot to command iine: 

Boot to desl(top: 


RASPBERRY PI ZERO 
TURBO OVERCLOCK 


Boot to command line: 

□□ nn ccr 

Boot to desl<top: 

□□ nn ccr 

-(-(.LIU -ICC.I 
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DESKTOP SETUP 

Wont to set up the Raspberry Pi Zero os o desktop 
repiocement? It's really quite simple - most 
of the hard work has been done for you already... 

First of all, there’s the hardware setup. To make 
the Pi Zero a desktop PC, you need the basic 
components: a monitor, keyboard, mouse, and 
wireless dongle. Connecting the monitor is easiest, 
as you just need to get a mini-HDMI to HDMI cable 
that can plug into a monitor with a HDMI port. For 
the rest of the components, you’ll need to first 
look into getting a USB hub that can be powered if 
need be - plug it into a micro-USB to USB adaptor 
and then plug in your keyboard, mouse, and WiFi 
dongle. If you have a spare port, you can now use 
that for a USB stick. 

Lastly, you’ll need to install Raspbian. This is 
dead easy: plug a microSD card into your normal 
computer (via an SD adaptor if needed) and unzip 
NOOBS to it, which you can download from: 
raspberrypi.org/downloads. Insert the microSD 
card into the Pi Zero, plug it in with a phone 
charger or an official Raspberry Pi power supply, 
and then choose to install Raspbian Jessie. 
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REMOTE ACCESS 


ESSENTIAL 




HOW TO CONNECT TO WIFI 
ON THE COMMAND LINE 


GIVE YOUR PI ZERO 
A NETWORK NAME 


If you set a static IP as shown in 
the wireless tutorial on this page, 
then youhl always be able to 
access the Raspberry Pi Zero with 
that IP address from any remote 
service. However, for those who 
want the easier automatic way, 
you can still make it just as easy 
to connect to the Zero over the 
network by setting up Zeroconf . 
From the command line or in the 
terminal, type the following to 
make sure it is installed: 

sudo apt-get install 
avahi-daemon 

By default, the Pi will now be 
accessible via raspberrypi. local 

over the local network. 






low'hatjiluq irlanO 

jci ’alinO i[>9t dhcp 
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To set a 
static IP on the 
desktop interface, 
you’ll have to 
go through the 
same process 
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On some 
versions of 
Raspbian, avahi 
it may already be 
installed 


While Raspbian makes it dead easy 
to connect to WiFi on the desktop 
interface, there’s a little more 
involved in getting it working 
from the command line. Before 
we begin, there is one trick you 
can do: if you set up the WiFi at 
the desktop, it will still work while 
in the command line. That isn’t 
always possible, though, so you 
may need to use the manual way. 

First, find out the name of your 
network and the password. In the 
Raspbian command line, type: 
sudo nano /etc/network/ 
interfaces. There will already be 
some information in here, but to 
get the wireless to connect, make 
sure the file has these lines in it, 
with your network name (SSID) 
and its password replacing what’s 
already here: 


allow-hotplug wlan0 
auto wlan0 

iface wlan0 inet dhcp 
wpa-ssid 

"MyWirelessNetwork" 

wpa-password 

"AGoodPassword" 

You can also give the Raspberry 
Pi a static IP. To do this, you first 
need to do some prep work which 
requires you to use a computer 
which is already connected to 
your wireless network. Open the 
command line in Windows or 
the terminal in OS X or Linux. 

For Windows, type ipconfig; for 
OS X and Linux, use if config 
followed by netstat -nr. Note 
the IP address (inet), the broadcast 
address, the subnet address, 
the router IP (Destination), and 
Gateway address. After that, 
modify the interfaces file like so: 

iface wlan0 inet static 
wpa-ssid "MyWirelessNetwork" 
wpa-password "AGood Pas sword" 
address [IP address] 
netmask [Subnet] 
network [Router address] 
broadcast [Broadcast 
address] 

gateway [Gateway] 
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THE RASPBERRY PI ZERO 


USE YOUR RASPBERRY PI 
FROM ANOTHER COMPUTER 


Thanks to a piece of software called 
RealVNC, you donh even need to 
plug your Pi Zero into a monitor 
to use its desktop; you can simply 
control it from another computer. 
First of all, go to magpi.cc/PiVNC 
and download RealVNC onto your 
Raspberry Pi. Also obtain a free 
licence key (magpi.cc/1O8Hz4J), as 
youTl be needing it. 

Once the file is on your Pi, 
open the terminal, use cd to 
navigate to the file in Downloads 
(cd Downloads should do) and 
use the following two commands, 
replacing the square brackets with 
the appropriate names: 

tar xvf [VNC file name], 
tar.gz 

sudo dpkg -i [VNC Server 
package name]. deb [VNC 
Viewer package name]. deb 

Copy the licence key you got 
and then run sudo vnclicense 



On some versions of Raspbian, Avahi 
may already be installed 


-add [License Key] with your 
key. Type vnc server into the 
terminal or command line for it 
to begin, type in your Raspberry 
Pi’s password (it’s raspberry by 
default) and make a note of the 
display number. In our case it was 
1, and as Avahi was installed, we 
can connect using raspberrypi : 1. 

Install a VNC viewer from 
here: magpi.cc/1M4uzfG 
on your platform of choice, 
and then connect with: 

raspberrypi: [Number] 


ACCESS YOUR PI REMOTELY FROM 
THE COMMAND LINE 


Via the SSH protocol, you can access 
the Raspberry Pi from any other 
computer on your home network. 
SSH should be activated by default, 
but to make sure it is on, you can go 
to Raspberry Pi Configuration from 
the Preferences category in the Menu 
(or by typing sudo raspi-config 
from the command line) and ensure 
SSH is turned on in the Interfaces tab 
(or under the Advanced menu in the 
command-line version). If SSH was 
disabled, enable it and reboot. 

In OS X and Linux, you can use SSH 
from the terminal; in Windows, 
however, you’ll need to download 
PuTTY (magpi.cc/lMm5Npi). 


From an OS X or Linux terminal, you 
can access the Pi remotely with: 

$ ssh pi@raspberrypi 

You will need to set up a network 
name (see box on previous page). 
Type yes to trust the connection, 
then enter the password raspberry to 
log in. If using PuTTY, just type pi@ 
raspberrypi into the address field 
and click Connect. Again, you’ll have 
to agree to trust the Pi Zero, then use 
the password raspberry. 

You can now control the Raspberry 
Pi in as you would normally do via 
the command-line. 


SHARE FILES ON YOUR 
NETWORK WITH SAMBA 


This is especially good if you want to use your 
Raspberry Pi Zero as a file server. For this, or just 
generally to be able to access the files on your Zero 
from anywhere on the network, you’ll need to 
use Samba. First, you need to install it: 

sudo apt-get install samba samba -common -bin 

You need to configure Samba to work as intended. 
Still in the terminal or command line, type: 

sudo nano /etc/samba/smb.conf 

First of all, if you have a Windows workgroup with a 
specific name on your network, find the line starting 
workgroup = WORKGROUP and change the uppercase 
WORKGROUP to your workgroup’s name. If you 
have no idea what a workgroup is, you can leave 
this setting alone. Find the line # wins support 
= no, delete the # character, and change the no 
to yes. Scroll down to the section labelled Share 
Definitions and enter the following chunk of code: 

[pihome] 

comment= Pi Home 
path=/home/pi 
browseable=Yes 
writeable=Yes 
only guest=no 
create mask=0777 
directory mask=0777 
public=no 

Press CTRL+X, then Y and ENTER to save the file. To 
start the sharing, enter the following in the terminal 
and use your Pi’s password (raspberry by default): 

smbpasswd -a pi 



The configuration file looks complicated, but you only need 
to change a couple of bits! 
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EASY PROJECTS 


WEB-CONTROLLED HTPC 


frc^ect 

data 


CATEGORY: 

Entertainment 

DIFFICULTY: 

Easy 


n HTPC (home theater PC) is an excellent use 
for the Raspberry Pi, and a very popular one 
thanks to the existence of Kodi - the media 
centre software - and operating systems that utilise 
it, such as OpenELEC and OSMC. Whereas before you 
could set up the Raspberry Pi as a very mini set-top 
box, the Raspberry Pi Zero can be stored covertly 
behind the television with a custom mounting or a 
good bit of Blu-Tack. 

If you’re sticking it behind a television and want 
to keep wiring to a very minimum, you can get away 
with just having a wireless dongle attached to a USB 
adaptor. This not only allows the Pi to connect online 
to watch streamed content, and to your network to 
play local media, it also opens it up to be controlled by 
the standard web controls. 

While the web controls can be used from a browser 
as original intended, you can also get remote control 
apps for smartphones and tablets (just search for 
Kodi or XBMC remote on your app store, there’s loads 



to choose from!) that make use of this web access 
to the HTPC. 

We recommend setting up the web access on 
a Pi Zero or normal Pi with keyboard and mouse 
connected, just to make it slightly easier. Head over to 
the Settings menu, then go to Services, Webserver and 
enable ‘Allow control of Kodi via HTTP’. Make a note 
of the IP address it gives itself, and use that to connect 
from your phone or browser. 


frojed 

data 


CATEGORY: 

Utility 

DIFFICULTY: 

Easy 
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ULTRA-LOW 
PROFILE FILE SERVER 


Upgrade your network- 
attached storage by making it 
much, much smaller 

The Raspberry Pi is the perfect low-power file 
server for your home, requiring very little wattage 
to keep running when idle, while also being very 
easy to access remotely via SSH over the network. 
With an original Raspberry Pi, it was a small setup, 
but now with a Pi Zero you can basically have a NAS 
box that is no bigger than 
the actual storage itself. 

Get a small USB hub, a 
portable USB hard drive, 
and a tiny USB dongle 
and you’ve got yourself 
a complete NAS box 
that can be controlled 
from anywhere on your 
local network. 




INCOGNITO 

COMPUTER 


frqject 

dcda 


CATEGORY: 


Keep your Raspberry Pi 
Zero hidden and safe in an 
inconspicuous tin of mints 

While you wait to get a case for your Raspberry Pi Zero, 
there’s a few things you can do to keep it safe from 
a normal dusty environment; you could keep it in an 
anti-static bag, the blister packet it came with on top 
of this magazine, or you could keep it hidden inside 
an Altoids tin. 

All you’d need to do is affix it to the tin, either with 
Blu-Tack or some carefully measured and drilled screw 
mounts, and cut a few holes to allow for connecting 
the normal cables to it. Quick, simple, and it makes 
you feel like a spy. 


Fun 

DIFFICULTY: 

Easy 
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THE RASPBERRY PI ZERO 


data 


CATEGORY: 

Utility 

DIFFICULTY: 

Medium 


PI ZERO GPIO 
SOLDERING 


'You’U 

tked 


> 2.54mm Male Pin 
Headers 

magpi.cc/ 

iPCpMVa 

> Soldering Iron 
and Solder 

magpi.cc/ 

lOasksX 


f you’re planning a project around the Pi Zero 
I which involves general-purpose input-output 
(GPIO), then you have a decision to make: you 
can solder your wires directly to the unpopulated GPIO 
header and dedicate the Pi Zero to the job, or you can 
solder a header block and make it easily detachable - 
just like on the Zero’s bigger siblings. 

Preparation 

Before you plug your iron in, get your workspace ready. 
That means making sure that it’s free from anything 
breakable or flammable, that you’ve put something 



Take your time when soldering the pins, and be careful not 
to connect two or more together with excess solder 


Finally, moisten your sponge, plug the iron in, and 



Pin headers are 
usually supplied 
in odd-numbered 
quantities, but 
they are easily 
snapped to 
length with 
nothing 
more than 
your fingers. 


Pick an iron with a 
reasonable power 
output, not below 
25W. and with a 
reasonable fine 
tip - not the sort of 
thing you’d use for 
plumbing repairs! 


> Blu-Tack 
(optional) 

> HAT (optional) 


protective down on the surface to guard against 
scorching from solder splashes, and that you’ve laid 
everything out where you can easily get to it. 

The GPIO header blocks themselves, technically 
known as 2.54mm male pin headers, will also need 
some preparation. They’re typically supplied in rows of 
36 or more, while the Pi’s GPIO block is laid out in two 
rows of 20. That’s easy to rectify: count 20 pins out, 
then put your fingernails in the divot between pins 20 
and 21 before snapping the excess off with a twist of 
your fingers. Do this twice and you’ll have the precise 
number of pins required. 


clean the tip by melting a small amount of solder 
directly to the metal before wiping it on the sponge. 

Saldering 

Putting the iron back in its stand for now, begin by 
putting the pins through the GPIO block of the Pi Zero, 
with the short ends sticking through and the black 
plastic blocks resting on the circuit board. You’ll need a 
way to hold these in place while you flip the Pi Zero: try 
a blob of Blu-Tack - or, if you have one, insert the long 
ends of the pins into a HAT or other accessory with a 
female GPIO header. 

Flip the Pi Zero over to expose the short pins, and 
begin soldering. Making sure the pins are properly lined 
up, target the bottom-right pin first. Place the heated 
iron against both the leg of the pin and the copper- 
coloured soldering point, and wait a couple of seconds 
for it to heat. Then, without removing the iron, touch 
the solder to the base of the pin. It should melt, then 
be quickly ‘sucked’ into the hole to make a conical 
connection; if not, reposition your iron and try again. 

With one down, it’s now merely a question of 
repetition: keep soldering each pin in turn, making sure 
not to use too much solder and cause a short, until they 
are all complete. Clean your iron’s tip, allow the Pi Zero 
to cool, and you’re ready to attach some GPIO hardware 
- or, optionally, wash off the soldering residue with ‘flux 
cleaner’ fluid for a neater finish. 
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Tutorial 


The HC-SR04 eyes provides 
that ‘signature’ Pi robot look 


AsD-printed 
KOROBOT shell 
and wheels, 
or some craft 
materials 
magpi.cc/ 
iPCfwMK 

HC-SR04 
ultrasonic sensor 

magpi.cc/ 

iPCfAMs 

Two 28BYJ-48 
stepper motors & 
ULN2003A driver 
boards 

magpi.cc/ 

iPCfCEs 


THE CASE 

This bot’s body is 
3D-printed. but 
the lightweight 
requirements 
mean that 
you can easily 
make one out 
of household 
scraps. 


he tiny form factor of the Pi Zero means 
T you can develop equally titchy and highly 

manoeuvrable hots. The Pi is not the only thing 
to get itself a ‘zero’ makeover. The fabulous GPIO Python 
library has recently been made even more ‘user-friendly’ 
and accessible through the new GPIO Zero library. 
Combined with the latest version of Raspbian (Jessie), 
we can also omit the ‘sudo’ before running our scripts. 
Coding robots has never been easier - or smaller! 

First of all, make sure you’ve got the latest version 
of pip for Python3: 

sudo apt-get update 

sudo apt-get install python3-pip 

Then install GPIO Zero (gpiozero) and the library we’ll 
use for our robot’s eyes. 

sudo pip install gpiozero hcsr04sensor 

stepper motors 

The 28BYJ-48 is a cheap but versatile stepper motor that 
can normally be bought with an ULN2003A driver board 
for under £4. Stepper motors can be programmed to 
move in discrete steps rather than just turned on/off like 
servos. Using the Pi Zero, you’ll be able to control the 
speed and positioning of the motors very accurately. To 


cause the motor to rotate, you provide a sequence 
of ‘high’ and ‘low’ levels to each of the four inputs. 

The direction can then be reversed by reversing the 
sequence. In the case of the 28BYJ-48, there are four- 
step and eight-step sequences. The four-step is faster, 
but the torque is lower. The example code lets you specify 
the number of steps through the seqsize variable. 

Each motor has a connector block at the end of its 
coloured wires that slots into the white header on 
the ULN2003A. The GPIO pins controlling that motor 
connect to the four input pins below the IC, while the 5V 
power and ground connections go to the bottom two pins 
on the right (see Fig 1 ). 

Eyes to see 

We’ll give our ZeroBot some simple ‘eyes’ that allow it 
to detect obstacles, courtesy of the HC-SR04 ultrasonic 
sensor. This has four pins, including ground (GND) and 
5V supply (Vcc). Using Python, you can tell the Pi to 
send an input signal to the Trigger Pulse Input (TRIG) 
by setting a GPIO pin’s output to HIGH. This will cause 
the sensor to send out an ultrasonic pulse to bounce off 
nearby objects. The sensor detects these reflections, 
measures the time between the trigger and returned 
pulse, and then sets a 5V signal on the Echo Pulse 
Output (ECHO) pin. Python code can measure the time 
between output and return pulses. Connect the HC- 


This bot s body 
is 3D printed but 
the light weight 
requirements 
means you can 
easily make one 
out of household 
scraps 


• The titchy Pi Zero means 
: that bot size can be 
: significantly reduced 
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ZEROBOT 


Tutorial 



Fig 1 There’s a lot of wiring for this bot. If motors don’t turn as 
expected, check the GPIO pins for the coils are connected correctly 


SR04 as shown in Fig 1. Its ECHO output is rated at 5V, 
which could damage the Pi. To reduce this to 3V, use 
two resistors to create a simple voltage divider circuit, 
as shown. 

The hcsro4sensor Python library provides a simple 
interface to enable our hot’s eyes. Once you have all your 
components connected, you can test the code on a bench 
before building the full robot. Point the ‘eyes’ away from 

Coding robots has 
never been easier... 

you and run the code. The red LEDs on the ULN2003AS 
should flash and both motors start turning. Our zerobot. 
py example has the bot move in a square. Check that the 
motors behave accordingly, then rerun the code, but this 
time place your hand a couple of centimetres in front of 
the HC-SR04 and check that everything stops. 

Now it’s time to give the bot a body. If you have access 
to a 3D printer, you can print the parts for the ZeroBot. 
This design fits together easily, although you do need 
to glue the chassis end-caps in place. Alternatively, you 
could construct a similar design using reasonably thick 
cardboard for the wheels and part of a plastic bottle as 
the main tubular chassis. Use more cardboard for the 
end-caps. 

Put your power bank at the bottom of the chassis tube, 
then attach the motors to the end-caps with screws. 
Next, place the ULN2003A boards on top of the power 
bank, and then sit the breadboard with the HC-SR04 
‘eyes’ on top. Finally, slot the Pi Zero in at the back. 

All nice and cosy, and ready to roll! 


raspberrypi.org/magpi 


zerobot^ 

import time, sys 
import gpiozero as g0 
from threading import Thread 
import hcsr04sensor .sensor as sensor 
INl_ml = g0.OutputDevice(17) 

IN2_ml = g0.OutputDevice(18) 

IN3_ml = g0.OutputDevice(21) 

IN4_ml = g0.OutputDevice(22) 

StepPins_ml = [INl_ml,IN2_ml,IN3_ml,IN4_ml] # Motor 1 GPIO pins 
IN4_m2 = g0.OutputDevice(19) 

IN3_m2 = g0.OutputDevice(13) 

IN2_m2 = g0.OutputDevice(5) 

INl_m2 = g0.OutputDevice(6) 

StepPins_m2 = [INl_m2,IN2_m2,IN3_m2,IN4_m2] # Motor 2 GPIO pins 
Seq = [[1,0, 0,1], # Define step sequence 

[1,0, 0,0], # as shown in manufacturers datasheet 
[1.1.0.0]. 

[0.1.0,0]. 

[0.1.1.0]. 

[0.0.1.0]. 

[0.0.1.1]. 

[0.0.0.1]] 

StepCount = len(Seq) 
all_clear = True 
running = True 

def bump_watch() : # thread to watch fro obstacles 
global all_clear 
while running: 

value = sensor .Measurement (20, 16, 20, 'metric', 1) 
if value. raw_distance() < 10: # trigger if obstacle within 10cm 
all_clear = False 
else: 

all_clear = True 

def move_bump(direction='F', seqsize=l, numsteps=2052) : 

counter = 0 # 2052 steps = 1 revolution for stepsize of 2 
StepDir = seqsize # Set to 1 or 2 for fwd, -1 or -2 for back 
if direction == 'B' : 

StepDir = StepDir * -1 

WaitTime = 10/float (1000) # adjust this to change speed 
StepCounter = 0 

while all_clear and counter < numsteps: # only move if no obstacles 
for pin in range(0, 4): 

Lpin = StepPins_ml[pin] 

Rpin = StepPins_m2[pin] 

if Seq[StepCounter] [pin] !=0: # F = fwd, B=back, L=left, R=right 
if direction == 'L' or direction == 'B' or direction == 'F': 
Lpin. on 0 # Left wheel only 

if direction == 'R' or direction == 'B' or direction == 'F': 
Rpin. on 0 # Right wheel only 
else: 

Lpin. off 0 
Rpin. off 0 

StepCounter += StepDir 

if (StepCounter>=StepCount) : # Repeat sequence 

StepCounter = 0 
if (StepCounter<0) : 

StepCounter = StepCount+StepDir 
time.sleep(WaitTime) #pause 
counter+=l 

tl = Thread (target=bump_watch) # run as separate thread 
tl. start 0 # start bump watch thread 
for i in range(4): # Draw a right-handes square 
move_bump( ' F ' , -2,4104) 
move_bump( ' R' , -2,2052) 

running = False December 2015 25 



>PYTHON 


DOWNLOAD: 

github.com/top- 

shed/ZeroBot 
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ZERO PROJECTS 


data 

CATEGORY: 

Fun/Home 

Automation 

DIFFICULTY: 

Medium 




• The USB power 
cable should fit 
easily through 
the existing hole 


• The small size of the 
Pi Zero means it easily 
fits into off-the-shelf 
diffusers, like this one 
rescued from an old 
table lamp 


ZER0 MOOD LIGHT 


GPIO headers 

magpi.cc/ 

iPCpMVa 

Unicorn HAT 

magpi.cc/ 

iPCpRZs 

USB WiFi dongle 
or second 
Raspberry Pi 

magpi.cc/ 

iPCpVbs 

Diffuser or 
Lamp housing 
(optional) 


hen the machine-to-machine 
w communications industry branched 

out into consumer products and became 
the Internet of Things (loT), it was only natural it 
would focus on easy wins, and with programmable 
RGB LEDs dropping in price, mood lighting was 
a great start. What took companies like Philips years 
of research and development, though, can now be 
achieved by the hobbyist in minutes. The Pi Zero’s 
low power draw and small size make it perfect for 
adding intelligence to even the smallest of household 
gadgets, and existing LED HATs are entirely 
compatible, meaning you can build something 
smart-looking in well under an hour. 

>STEP-01 

Install Unicorn HAT 

If your Pi Zero is fresh from the factory, you’ll need to 
solder on a set of GPIO headers before you can attach a 
HAT (Hardware Attached on Top). If you haven’t done 
so, head on over to page 23 to see how this is done. 

With headers in place, installing the Unicorn HAT is 
no more difficult than with any other Pi model: place 
it carefully on top of the male pins, making sure that 


you’ve lined it up properly without skipping a column 
and that the body of the HAT is covering the body of 
the Pi Zero, then push down firmly. 

>STEP-02 

Install saftware 

You’ll need some extra software to run the Unicorn 
HAT, which can pose a problem for the network-less 
Pi Zero. You can either connect a USB WiFi dongle 
with a USB OTG adaptor, or remove the microSD 
card and insert it into a networked Raspberry Pi to 
perform this step. 

At the terminal, type the following three commands 
to install the software you’ll need to control the 
Unicorn HAT’s numerous LEDs: 

sudo apt-get update && sudo apt-get 
upgrade 

sudo apt-get install python-dev 
sudo pip install unicornhat 

If you’re using a networked Pi for this, shut down 
when you’re done and put the microSD card back 
in the Zero. 
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>STEP-03 

WritG thG codG 

For a true Hue-like experience, you’re going to need 
some pretty advanced code. For a simple colour- 
cycling mood light, however, you need only a handful 
of lines of code. You can either write your own or 
use the rainbow. py example provided by Pimoroni 
specifically for the Unicorn HAT. 

For now, even if you’re looking to write your own, 
try typing in the included code - either at the terminal 
using nano or in IDLE at the desktop - and saving it 
in your home directory as rainbow. py. Remember to 
watch out for typos! 

>STEP-04 

Configure on-boot behaviour 

Nobody wants to have to plug a keyboard and mouse 
into their lamp every time they turn it on, so we want 
the rainbow. py code to run every time the Pi Zero is 
switched on. At the terminal, type: 

sudo nano /etc/rc. local 

Type the following line in, just below the lines 
commented out with hash symbols: 

python /home/pi/rainbow. py & 

The last symbol, an ampersand, is important: it 
allows the Python program to run in the background 
and not tie up the Raspbian boot process. Save with 
CTRL+0, and exit with CTRL+X. 

>STEP-05 

Shut down and install 

By itself, the Unicorn HAT is a little distracting. To 
tone things down a little, have a look in cheap or 
second-hand electrical shops for a lamp - functional 
or otherwise - from which you can steal a diffuser. 

If you can’t find one, try building your own out of 
translucent plastic, paper, or cloth. 

Shut the Pi down with the following command: 

sudo shutdown -h now 

Disconnect the USB power cable and carefully 
install the Pi Zero and Unicorn HAT in the diffuser. 
You can either screw it in place through the 
mounting holes, or use Sugru or Blu-Tack for a more 
temporary arrangement. 

>STEP-06 

PawGr an and Gnjay 

Route a micro-USB cable through the diffuser and 
connect it to the Pi Zero’s power socket, situated at 
the far right. Since a USB cable is thinner than the 
mains lead used with many lamps, the diffuser’s 


rainbow^ 

#!/usr/bin/env python 
import unicornhat as unicorn 
import time, math, colorsys 


print( "Reticulating splines") 
time.sleep( .5) 

print( "Enabled unicorn poop module!") 
time.sleep(.5) 

print ("Pooping rainbows...") 

unicorn . brightness (0. 1) 

i = 0.0 
offset = 30 
while True: 


\ignqu^ 

>PYTH0N 

DOWNLOAD: 

magpi.cc/iiUiQFV 



for y in range(8): 

for X in range(8): 

r = 0#x * 32 
g = 0#y * 32 
xy = X -I- y / 4 
r = ( 

math. COS ((x-i-i)/2.0) -i- math.cos((y-i-i)/2.0)) * 64.0 -i- 128.0 
g = ( 

math.sin((x-i-i)/1.5) -i- math.sin((y-i-i)/2.0)) * 64.0 -i- 128.0 
b = ( 

math. sin ((x-j-i)/2.0) + math.cos((y-Hi)/1.5)) * 64.0 -i- 128.0 
r = max(0, min(255, r -i- offset)) 

g = max(0, min(255, g -i- offset)) 

b = max(0, min(255, b -i- offset)) 

unicorn . set_pixel ( 

x,y,int(r),int(g),int(b)) 
unicorn. show() 
time.sleep(0.01) 



The small size of 
the Pi Zero means it’s 
hidden away entirely 
underneath most 
HATs, making for a 
compact build 


existing hole for the old cable should work nicely 
for this. Position the lamp wherever you like, and 
then connect the USB cable to a power supply. 

After a few seconds, the LEDs should start cycling 
through various colours and brightnesses: you’ve 
built your mood lamp! 

From here, consider adding new features: a WiFi 
adaptor and some clever Python code would let you 
control the light from your smartphone, or you could 
even have it react to weather or stock price tickers. 
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CATEGORY: 


DIFFICULTY: 

Medium 


• This enclosure 
is watertight, so 
take this project 
in the rain or on 
the open seas _ 


• The GPS receiver 
sends location 
data via serial 


The Raspberry 
Pi Zero uses 
Python to log 
the locations to 
a text file 


over USB to the 


Raspberry Pi 


LOGGER 


USB battery pack 


Enclosure 


Micro-USB to 
USB adaptors 


GpsPrune 

magpi.cc/ 

iPxOsFg 


GPS basics 

As we’re sure you know, GPS technology uses 
satellites orbiting the Earth in order to determine your 
position with longitude and latitude coordinates. So 
as you work on this project, it helps if the GPS receiver 
has a clear line of sight to the sky. If you’re working 
indoors, you may want set yourself up near a window 
and have the GPS receiver positioned facing upwards 
outside the window. 


sing off-the-shelf components and a 
U Raspberry Pi Zero, you can create a small and 
inexpensive GPS location logging device to 
take hiking, kayaking, or in the car. And since the 
Raspberry Pi is a full computer, you can even connect 
a monitor, keyboard, and mouse to it so that you can 
view your routes on a map and analyse the data you’ve 
collected. In this project, you’ll learn about how GPS 
devices deliver location information over serial, and 


J 





r 




kr 


how you can use Python to parse and save that stream Most USB GPS receivers should work, but we’d 


of data to a file. 


definitely favour those devices that have clear 
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You'll learn about how GPS devices deliver 
location information over serial, and how you 
can use Python to parse and save that stream 


documentation with their serial settings such as baud 
rate (the speed it sends bits). When researching a 
particular receiver, search online for its model number 
and the phrase ‘baud rate’, and make sure that others 
have had success reading data via serial. The model we 
used was a GlobalSat BU-353. Its baud rate is 4800. 

The first thing youTl want to do with your GPS 
receiver is peek at the serial data coming in and make 
sure you have your settings correct. Immediately after 
plugging your USB GPS receiver into your Pi Zero, run: 

tail -f /var/log/syslog 

Look for a recent log entry towards the bottom 
that shows something like ‘PI2303 converter now 
attached to ttyUSBoL This means that the GPS 
device is now connected and can be used as 
/dev/ttyUSBo. To set that port’s baud rate, execute 


stty according to the following example for a 4800 
baud device on /dev/ttyUSBo. 

stty -F /dev/ttyUSB0 4800 

To view the data coming in from the GPS receiver, 
execute the following command: 

cat /dev/ttyUSB0 

You’ll see a lot of data coming in, each line starting 
with SGPRMC or similar with comma- separated data 
following. These are NMEA sentences, which are 
standard ways of communicating certain types of 
data, including location. It’s a standard set by the (US) 
National Marine Electronics Association. The code will 
be reading the RMC sentence, which has all the data 
you’ll need. 


The Pelican 
1010 case includes 
a carabiner, which is 
useful for this project 
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mn 

>PYTHON 

try: 

decimalPointPosition = data.index( ' . ' ) 



degrees = float (data [ :decimalPointPosition-2] ) 

import serial 

DOWNLOAD: 

minutes = float (data [decimalPointPosition-2 : ])/60 

import os 

magpi.ee/iPxPopi 

output = degrees + minutes 


firstFixFlag = False 

# will go true at first fix 
firstFixDate = "" 

# Set up serial: 
ser = serial. Serial( 

port= ' /dev/ttyUSB0 ' , \ 
baudrate=4800A 
parity=serial . PARITY_NONE, \ 
stopbits=serial . STOPBITS_ONE , \ 
bytesize=serial . EIGHTBITS A 
timeout=l) 

# Helper function to take HHMM.SS, 

# Hemisphere and make it decimal: 

def degrees_to_decimal(data, hemisphere): 


return output 

if hemisphere is 'S' or hemisphere is 'W: 
return -output 

except: 

return "" 

# Helper function to take a $GPRMC sentence^ 

# and turn it into a Python dictionary. 

# This also calls degrees_to_clecimal and stores 

# the decimal values as well, 
def parse_GPRMC(data) : 

data = data.split( ' j ' ) 
diet = { 

'fix_time' : data[l]j 
'validity': data [2], 

'latitude': data [3], 



GpsPrune runs on the Raspberry Pi 
and Lets you view the data on a map 


The key fields of an 
NMEA RMC sentence 


DATA 

DESCRIPTION 

FORMAT 

$GPRMC 

Protocol header 

- 

204311-602 

Time (UTC) 

hhmmss.sss 

A 

Status 

A (valid) or V (not valid) 

3747-3392 

Latitude 

ddmm.mmmm 

N 

Northern / Southern 

Hemisphere indicator 

NorS 

12223.8954 

Longitude 

ddmm.mmmm 

W 

Eastern / Western 

Hemisphere indicator 

EorW 

061115 1 

1 Date 1 

1 ddmmyy 


Here’s an RMC sentence from my unit: 

$GPR|V1C, 204311 . 602, A, 3747 . 3392, N, 12223 . 8954, 
W,0. 50, 324. 18, 061115,,, A*7A 

The fields youTl be interested in are in Fig i. 

The other fields describe speed, course, magnetic 
variation, and the final field is a checksum. We won’t 
be using them for this project. 

Press CTRL+C to get back to the command line and 
proceed if you’ve confirmed the path of the serial port 
and the baud rate. 

Parsing the data and saving it 

While there are drivers and code libraries for working 
with GPS devices, we decided to parse the NMEA 
sentences manually in Python, since that language 
is especially good for working with text. The main 
purpose of the Python script is to log the latitude and 
longitude to a text file with comma-separated values. 
That’s what it does in the main loop at the bottom of 
the code. You might notice that it will only log to file 
when there’s a valid fix. You can tell if there’s a valid 
fix when the status field has the letter A. 

The code has two helper functions. The first helper 
function takes the full NMEA sentence and creates a 
Python dictionary out of the data. This just makes the 
data easier to work with in case you want to enhance 
the script for your project. 

The other helper function takes the degrees-minutes 
and hemisphere data that the GPS outputs and converts 
it into decimal degrees. Working with decimal degrees 
will be easier if you want to enhance the project to 
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'latitude_hemisphere' : data [4] j 
'longitude' : data [5], 

'longitude_hemisphere' : data [6], 

'speed': data[7], 

'true_course' : data[8]j 
'fix_date': data [9], 

'variation': data[10], 

'variation_e_w' : data [11], 

'checksum' : data[12] 

} 

dict[ 'decimal_latitude' ] = degrees_to_ 
decimal(dict[ 'latitude' ], dict[ ' latitude_hemisphere' ]) 
dict[ 'decimal_longitude' ] = degrees_to_ 
decimal(dict [ ' longitude ' ] , diet [ ' longitude_hemisphere ' ] ) 
return diet 

# Main program loop: 
while True: 

line = ser.readlineO 

if "$GPRMC" in line: # This will exclude other NMEA 
# sentences the GPS provides. 


gpsData = parse_GPRMC(line) # Turn a GPRMC sentence 
# into a Python dictionary called gpsData 
if gpsData [ 'validity ' ] == "A": 

# If the sentence shows that there's a 

# fix, then we can log the line 
if firstFixFlag is False: 

# If we haven't found a fix before, set 

# the filename prefix with GPS date & time. 
firstFixDate = gpsData [ 'fix_date ' ] + 

gpsData [ 'fix_time' ] 

firstFixFlag = True 

else: # write the data to a simple log file and 

# then the raw data as well: 

with open("/home/pi/gps_experimentation/" + 
firstFixDate +"-simple-log.txt", "a") as myfile: 

myfile.write(gpsData[ 'fix_date' ] + "," + 
gpsData [ 'fix_time' ] + + str(gpsData[ ' decimal_latitude ' ] ) + 

"," + str (gpsData [ 'decimal_longitude' ] ) +"\n") 

with open("/home/pi/gps_experimentation/" + 
firstFixDate +"-gprmc-raw-log.txt", "a") as myfile: 

myfile. write( line) 


check if you he within a certain boundary. Also, a lot of 
mapping tools such as Google Maps use decimal degrees. 

After you clone the GitHub repository, edit gps.py 
with the port name and baud rate for your device. Also, 
adjust any file names and paths as you see fit. 

To get it to boot on startup: 

sudo nano /etc/rc. local 

. . .And add this line before exit 0: 

python /home/pi/gps_experimentation/gps.py & 

Now, whenever you boot your Raspberry Pi Zero, the 
project will log all valid GPS location fixes to a file. 

Viewing the data 

To view your logged data, plug the Raspberry Pi into a 
keyboard, monitor, and mouse and boot it up. Install 
GpsPrune from the command line with: 

sudo apt-get install gpsprune 

Launch it by typing gpsprune. Within GpsPrune, 
click File > Open, and choose the log file. The default 
options should work just fine. NowyouTl be able to 
view the GPS data overlaid on the map! 

This is a very basic GPS project and hopefully gives 
you enough of an idea how to work with GPS data. 

You can start here and enhance the project in order 
to do much cooler stuff. For example, you can make a 
‘reverse geocache’, which is a box that only unlocks 
when it’s in a certain part of the world. 
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• The Pi Zero 
is a great size 
for wearable 
technology 


CATEGORY: 

Utility 


DIFFICULTY: 

Advanced 


Battery 

Display 

Real-time clock 
(optional) 

Buttons and/ 
or a very small 
joystick (optional) 

Accelerometer 

(optional) 

WiFi or Bluetooth 
breakout board 
(optional) 


PI ZER0 

CONFERENCE 

BADGE 


A small 
LCD would be 
sufficient to show 
the delegate's 
name and basic 
information 



onference badges can be very dull: a boring 

C piece of card with your name on the front 

and - if you’re lucky - a brief schedule on the 
back. The Pi Zero offers some fantastic opportunities 
for producing a truly disruptive digital badge. 

The possibilities are endless, but there are a couple 
of key things youTl probably want to include: a 
battery and a display. 

As it is going to be hanging around someone’s 
neck, weight is obviously a key issue. A standard 
power bank (like the ones used for recharging 
phones) would probably be too heavy, but some of 
the skinnier credit card-sized examples might be 
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/ILI934I&C 


A big TFT screen could provide a fabulous display for the badge 


(LiPo) 


workable. Alternatively, a lithium polymer 


GOES WELL WITH... 


POTHOLE MAPPER 

The Pothole Mapper already uses an accelerometer 
to detect movement of the Pi Zero. You could then 
use the GPS capability to guide your delegates 
around the local area, helping them to find hotels and 
recommended restaurants, for example. 


THINK OF IT LIKE... 


A PI VERSION OF BAOGEr 

These were produced for the Open Hardware 
Summit in 2013 and based on the Arduino derivative 
ATmega328. The Pi Zero allows you to have a fully 
functional Linux computer hanging from your lanyard 
and takes this concept to the next level. 

accelerometer could detect when the badge was being 
held up rather than just dangling, and automatically 
switch from displaying the attendee’s name to 
showing the schedule. The addition of a real-time 


battery could be a better option and would also allow clock would make it possible to set alerts to remind 
a long time between recharging. the delegate when particular talks or sessions were 

When it comes to displays, you’re spoilt for choice. about to start (maybe by flashing the screen or 

There are some great LCD units available in a range through the inclusion of a vibration motor), 

of sizes: the 16x3 character LCD used on the Pimoroni If you’re feeling super-ambitious, there is also the 

Display-o-Tron devices is a good basic example, option of adding some kind of network connectivity, 

as you can add your own backlight. If you want This would allow you to update the conference 

something bigger, a display like the 84x48 Nokia schedule on the badge if there were any changes or 

5110 would allow you to design a fantastic animated additional last-minute events. Having only micro- 
presentation of the delegate’s name. Or if you really USB sockets means that you won’t be able to use 

Why stop there? Add a version of Snake or Flappy Bird 
to keep the attendees occupied in the lunch queue 

want to go to town, how about a Seeed 128x64 LCD a standard WiFi dongle without an adaptor, but 

(which uses the handy PC bus) or even an Adafruit there are a range of small WiFi breakout broads that 

2.2" 18-bit colour TFT LCD? could be incorporated into the design. Bluetooth 

What about interactivity? Obviously, with the might be another alternative. However, don’t forget 

Pi Zero you could just connect a regular keyboard that every component you add will increase the 

and talk to the Pi Zero that way. But why not weight and battery life of your badge. Unless you’re 

make it easier by adding some buttons and a small really out to impress, some of the more advanced 
digital joystick (like the one on the Sense HAT)? functionality might be overkill for a simple, one-off 

A simple on-screen menu could allow the delegate conference. Adding in and supporting any kind of 

to customise their display (even seemingly tiny network architecture is not for the faint-hearted, 

modifications like changing the font and size can However, if you run regular events and have your 

have a big impact). own site, it might be worth the extra development 

Why stop there? Add a version of Snake or Flappy time. If that’s the case, you might also consider a 

Bird to keep the attendees occupied in the lunch final enhancement: how about some kind of RFID 

queue. Store the conference schedule on the Pi Zero capability to stop people forgetting’ to hand 

and enable that to be displayed on the screen too. An in their badges after their visit. 
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CATEGORY: 

Fun 

DIFFICULTY: 

Easy 


^ouU 

1teed 


> Bare Conductive 
Electric Paint 

magpi.cc/ 

iSKZeRE 


> LEDs (even 
better if you can 
get components 
designed for 
e-textiles) 


> Paper, fabric, 
T-shirt - 
something to 
work on 


You can use 
electronic paint to 
embed LEDs into 
your painting 


MAKE AN INTERACTIVE MASTERPIECE 
WITH PI ZERO AND ELECTRIC PAINT 


P i Zero is ideal for conductive paint projects: 
without the GPIO header pins, you can blob 
paint right onto the contact and then paint 
a line to your LEDs, buttons or sensors. The paint is 
made from carbon and can be used on paper, fabric, 
wood, glass, and lots of other surfaces. It’s often 
referred to as cold soldering, because you don’t need 
a soldering iron! 

There are a few things to remember, though. First, 
conductive paint circuits work the same way as with 
wires or a breadboard: you have to paint GND to 
GND, and power to power (or GPIO). However, paint 
has much more resistance than wire, so if you put 
your components miles away and your paint line is 
really long, then you may not have enough current 
for it to work; you can check the resistance with a 
multimeter. This also means that the Pi Zero doesn’t 
need a resistor when controlling a LED: the paint 
is your resistor! 

Next, don’t cross the streams! The paint lines must 
never cross, as this shorts the circuit just like wire. 
Similarly, be very careful when blobbing paint onto 
the Pi Zero GPIO pin holes; make sure your paint 
tube is clean, and very carefully blob one pin at a 


time, making sure the paint gets nowhere else. It’s 
conductive, so covering your Pi in paint will short all 
the circuits and will likely break it. 

For this wiring, there’s luckily a good selection 
of 5V, GND, and GPIO pins on the outer edge of the 
Pi Zero board; if for any reason you need to get to 
the inside pins, you can cover the outside hole with 
electrical tape, blob paint on the desired hole, and run 
the paint over the tape. 

Lastly, a few extra things to keep in mind: don’t 
water down your paint! If using a brush, make sure it 
is clean and dry. Also, wait for the paint to dry. The 
paint becomes more conductive as it dries out, so be 
patient; if your LED isn’t lighting up right away, you 
may just need to leave it for a few minutes in a warm, 
dry place. 

Otherwise, any LEDs or sensors should work, but 
it’s easier to use components designed for e-textiles 
because they generally have nice big pads. Stick your 
Pi Zero to the paper with some double-sided sticky 
tape to keep it in place, or sew it into fabric using the 
mounting holes. 

You could use this technique to make an interactive 
T-shirt or birthday card. 
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Need to know if 


someone’s borrowed something? 


Simple pressure pads or an RFID 


reader will get you on the right track 


Want to know how 


hard you’re being tackled? Just grab 


an accelerometer and a mini battery 


pack to get cracking 


TOYS, WEARABLE TECH AND MORE 


Wow your family and 
friends with an amazing Christmas 
light display 


OTHER THINGS TO MAKE WITH 

PI ZERO 


Grab something 
from a budget 
store and open 
it up - you’ll be 
amazed at what 
you can do! 
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A Microstack GPS 
module 

magpi.cc/ 

iSxoBCP 

An accelerometer 

magpi.cc/ 

iSxoGWX 

A 40-pin 
male header 

magpi.cc/ 

iSxoFlV 

A box, some 
cable ties, and 
a bike 



Use your 
data to map out the 
ruts and potholes 
on the roads around 
you. Hack the 
code to adjust the 
granularity of the 
plotted points 




POTHOLE 

MAPPER 


• Ithough the Raspberry Pi A+ is a wonderfully 
small and low-power project-friendly device, 
it's still a little chunky for some applications. 
However, the Pi Zero's tiny form factor opens up a 
whole range of possibilities - in this case, mounting it 
to the forks of a bicycle. Wehl use an accelerometer to 
measure the deflection of the sensor as you bump and 
bounce around the mean streets of wherever you live, 
and use a GPS module to record your position. 


TheAdafruit 
LSM303 contains an 
accelerometer and 
a magnetometer 


You don't need 
a Microstack 
baseboard - Just 
connect directly 
to the pins on the 
GPS module 


Python! only. You can either update it yourself, or 
download a modified version by cloning the GitHub 
repository for this project. 


>STEP-01 

Solder on 0 heoder 


git clone https://github.com/topshed/ 
PiPotholeMapper 


Obviously, the Pi and the components are going to 
be subject to lots of vibrations, so the connections 
between them need to be solid and robust. Although 
you can get away with wedging a female GPIO header 
into the Pi Zero and bending the legs, this is only really 
good enough for simple bench tests, so youhl need 
to add a permanent male header that can be used for 
prototyping and the final device. Make sure your Pi 
Zero is held tightly when soldering the header, and 
avoid touching any of the adjacent components with 
the tip of the iron. 

Now configure the Pi using the new Raspberry Pi 
Configuration GUI tool that comes with the Jessie 
version of Raspbian: under the Interfaces tab, enable 
PC and disable Serial. 

>STEP-02 

Accelerometer 

There are plenty of accelerometers available, but this 
tutorial assumes you’re using the LSM303 which also 
includes a magnetometer. Unfortunately, the latest 
official version of the LSM303 Python library is for 



»i M»42i«aeeew7. »*o 


YouTl also need to install the Python3 smbus library. 

sudo apt-get install python3-smbus 

Connect the accelerometer as shown in the main 
image, and then run the example Python script to test 
that it works. 

cd PiPotholeMapper 
pythons Adafruit_LSM303.py 

Jiggle the LSM303 around and you should see the 
changing values for the x, y and z axes displayed. 

>STEP-03 

Find my Pi 

Now add the GPS module. Once again, there are several 
available. This tutorial describes the Microstack board 
because it tends to be one of the cheapest. Don’t worry 
if you haven’t got a Microstack Base Board, however, 
as we’re going to connect the GPIO pins directly to the 
GPS module itself. 

Power on the Pi and install the relevant software: 



sudo apt-get install pythonS-microstacknode 

Put your Pi and GPS module on the windowsill or 
somewhere else with an unobstructed view of the sky, 
so it can receive a signal from at least three satellites 
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and carry out the trilateration process needed to 
calculate position. You should see a red LED start to 
flash on the board after a few minutes; this means it 
has received a GPS lock and knows its position. 

>STEP-04 

The code 

Now run the pothole. py code: 

pythons PiPotholeMapper/pothole . py 

Check that a logfile is created - it should be named 
pothole< date +time>. log - and that it contains GPS 
and accelerometer data. Ideally, you should always 
wait until the GPS module has achieved a signal lock 
(as indicated by the flashing red LED) before running 
the Python script, as the Microstack library does not 
seem to always report the change of state correctly. 

>STEP-05 

Go for 0 ride 

Once everything is working, take it for a test drive. 
Although jumper leads and a breadboard won’t 
provide a reliable long-term build, they should 
survive a short test. In order to attach them to a bike, 
you’ll need some sort of container. The Pi Zero is so 
small that there are plenty of suitable boxes around; 
a box previously containing ten AA batteries and 
reinforced with some duct tape is ideal. Carefully fit 
the Pi Zero and breadboard inside, and then fill any 
space with scrunched-up paper to prevent things 
rattling around. Attach the box and the power bank to 
the bike forks with cable ties. 

>STEP-06 

Process the results 

Depending on how your accelerometer is oriented 
and attached to your bike, one or more of the axes 
may be most representative of the terrain over which 
you've travelled. The code records the data from all 
three axes, both from the accelerometer and the 
magnetometer. Once you’ve finished your test ride, 
have a look at the data using LibreOffice Calc or 
another spreadsheet app, and plot some charts of the 
data to work out which is most useful. 

The GitHub page for this project also contains 
some Python code to process and plot the results 
on a map. This assumes that the x-axis is the 
most useful column in terms of representing the 
bumpiness of your route. 

When you’re happy with your prototype, you can 
construct a permanent version. If you’re an expert 
de-solderer or not concerned about reusing your Pi 
Zero for other projects, you can just solder the wires 
required for the components directly to the GPIO 
header holes. Otherwise, use a ribbon cable to attach 
to a header. 


pothole^ 

import microstacknode. hardware. gps.l80gps as mst 
import Ism # Our PythonB version of the LSM303 
library 
import time 


>PYTH0N 3 
DOWNLOAD: 

magpi.cc/iPKzkoj 


print( 'Starting potholemapper ' ) 

tmstmp = time.strftime("%Y%m%d-%H%M%S") # Detaojs for output file 
f = open (' pothole '+ tmstmp+' .log' , 'w' ) # Open output file for writing 
gps = mst.L80GPS() # Connect to the GPS 

Ism = lsm.Adafruit_LSM303() # Connect to the accelerometer 
time.sleep(l) 


# Define useful functions 

def lock_check() : # Checks to see if we have a GPS lock 
try: 

X = gps.get_gprmc() 
return True 

except mst .DataInvalidError : 
return False 


def getLatLon(): # Read lat and Ion from GPS module 
coords = gps.get_gpgll() 
lat = coords [' latitude' ] 

Ion = coords [' longitude ' ] 
return lat, Ion 

def getAccel(): # Read values from accelerometer and magnetometer 
acc = Ism.readO 
a_x = acc[0] [0] 
a_y = acc[0] [1] 
a_z = acc[0][2] 
m_x = acc[l] [0] 
m_y = acc[l] [1] 
m_z = acc[l][2] 

return a_Xj a_y, a_Zj m_Xj m_y, m_z 

while True: # Main code loop 
if lock_check() : 
while True: 
try: 

pos = get Lat Lon 0 # Get our position 
for t in range(10) : 

# Take 10 readings from accelerometer for each GPS reading 
bumps = getAccelO 
# Write CSV formatted output 
f .write(str(pos)+ ',' + str(bumps) + '\n') 
time.sleep(0.1) 
except mst .DataInvalidError : 
f.write('No GPS lock\n') 

else: 

f.write('No GPS lock\n') 
print ( 'No GPS Lock' ) 
time. sleep(60) 
f .closeO 
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frc^ 

(Uda 


CATEGORY: 

Utility 

DIFFICULTY: 

Advanced 


3.3V USB TTL 
serial dongle 

magpi.cc/ 

iHVkwWn 

Femalejumper 

cables 

magpi.cc/ 

iHVnLNx 

GPIO headers 

magpi.cc/ 

iPCpMVa 


You only need 
to connect the TX 
and Ground pins 
on the Pi‘s GPIO 
header, but make 
sure you haven’t 
made a mistake! 



• All Raspberry 
j Pis include 

: an integrated 
: hardware random 

• number generator 

: (HWNG).andthePi 
: Zero is no exception 


A cheap dongle lets 
you connect the 
3.3V TTL serial on 
the Pi’s GPIO header 


TRUE 

RANDOM 

NUMBER 

GENERATOR 


ZERO PROJECTS 


I 0 server administrator would argue that 
IM cryptography isn't important, and few would 
try to claim that cryptography without 
entropy - a source of good-quality randomness - is 
in anyway secure. Previous solutions to the problem 
have included everything from webcams pointing at 
lava lamps, to expensive hardware random number 
generators. However, you can achieve the same effect 
for your Linux server with your Pi Zero, thanks to a 
hardware random number generator (HWRNG) built 
directly into its chip - and at a fraction of the cost of 
an off-the-shelf equivalent. 

>STEP-01 

Prepare the Pi 

If you havenh yet soldered GPIO headers onto your Pi 
Zero, head over to page 23 to see how it’s done. 



With the Pi Zero powered on, enter the Raspberry 
Pi Configuration tool by typing the following at the 
console (or in a terminal): 

sudo raspi-config 

Choose ‘8 Advanced Options,’ ‘A8 Serial,’ and confirm 
that you do not want the serial console active by 
choosing ‘No’. Choose ‘Finish’ then allow the Pi to 
reboot; this will free up the serial port on the GPIO 
header for our own use, rather than automatically 
spawning a console session. 

>STEP-02 

Activate the HWRNG 

While all Pis have a built-in hardware random number 
generator, it’s disabled by default. To enable it, edit 
the modules file with the following command: 

sudo nano /etc/modules 

At the end of the file, place a line reading: 

bcm2708-rng 

Place a blank line beneath it, then save the file and 
quit by pressing CTRL+0 and then CTRL+X. To avoid 
having to reboot again, finish with the following 
command at the console: 
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sudo modprobe bcm2708-rng 

You can then test the module with the following 
command, which should print gibberish to 
the console: 

sudo dd if=/dev/hwrng count=l 
iflag=fullblock 

>STEP-03 

Link the HWRNG to serial 

By default, the HWRNG module can only be used 
locally on the Pi itself. To use it as an entropy source 
for an outside system, we need a way to transfer the 
data — and the easiest way is via the serial port. Edit 
the rc. local file with the following command: 

sudo nano /etc/rc. local 

Just below the hashed-out comment section, add 
the lines: 

stty -F /dev/ttyAMA0 -echo raw 115200 
dd if=/dev/hwrng of=/dev/ttyAMA0 & 

Save the file with CTRL+0, then quit with CTRL+X. 
These lines configure the port, then continuously 
copy the output of the HWRNG to the serial port. 

>STEP-04 

Wire the TTL serial adaptor 

Most desktops, laptops, and servers have their 
TTL serial ports hidden from prying eyes - if they 
have any at all. To interface the Pi with your target 
system, youTl need a USB TTL adaptor suitable for 
3.3V usage - this should cost no more than £4 for the 
features wehe using. Before doing any wiring, shut 
down and power off the Pi. 

Using the female jumper cables, wire the TTL 
adaptor’s RX (receive) pin to the Pi’s TX (transmit) 
pin - physical GPIO pin #8; and ground to ground 
- physical GPIO pin #6. Leave the other TTL 
pins disconnected. 



You’ll need to disable the Pi Zero’s serial console, which is 
most easily done through the raspi-config utility 


>STEP-05 

Cannect ta the server 

The Pi Zero requires so little power that it can be 
run from a server’s USB 2.0 or higher port, meaning 
you won’t need a separate power supply. Double- 
check your wiring, then connect the Pi’s micro- 
USB power cable to one USB port, and the USB TTL 
adaptor to another. 

The USB TTL adaptor will show up on your host 
system as various device names depending on model. 

On the server’s console, type the following: 

Is /dev/tty* 

From the list that appears, look for a device called 
/dev/ttyACMo or /dev/ttyUSBo; you’ll need this for the 
next step. 

blacklaw@AUair:-$ dd Ifs/dev/ttyUSBO ofstestrandon. rnd counts8192 
0+8192 records in 
185+1 records out 

94764 bytes (95 kB) copied, 8.31518 S, 11.4 kB/S 
blacklaw^ltair:-$ ent test random, rnd 
Entropy = 7.997921 bits per byte. 

Optimum compression would reduce the size 
of this 94764 byte file by B percent. 

Chi square distribution for 94764 samples is 273.30, and randomly 
would exceed this value 25.00 percent of the times. 

Arithmetic mean value of data bytes is 127.7749 (127.5 » random). 

Monte Carlo value for Pi is 3.153855895 (error 0.39 percent). 

Serial correlation coefficient is -0.003375 (totally uncorrelated = 0.0). 
blacklaw^ltair:-$ | 

>STEP-06 QUICK TIP 2 

Gather same entrapy 

On the server, configure the serial port: 


QUICK TIP 1 


Make sure that 
any TTL adaptor 
you buy is suitable 
for 33V logic, and 
take extra care 
when wiring it to 
the GPIO header. 


The quality 
of the random data 
transmitted from 
the Pi’s HWRNG is 
enough for topping 
up /dev/random 
in Linux 


Stty -F /dev/ttyAMA0 -echo raw 115200 

Next, copy some data: 

sudo dd if=/dev/ttyUSB0 count=l 
iflag=fullblock 

If there’s no gibberish, check your wiring and entries 
in the Pi’s rc. local file. 

To use the data, install the rng-tools package: 

sudo apt-get update && sudo apt-get install 
rng-tools 

Then add the following two lines to the server’s 
/etc/rc. local file: 

stty -F /dev/ttyAMA0 -echo raw 115200 
rngd -b -r /dev/ttyUSB0 -W 3686 & 

Reboot the server. When the system’s entropy pool 
drops below 3,686 bits, rngd will automatically fill it 
again from the Pi’s HWRNG. 


If your TTL adaptor 
has a 5V power 
output, it may be 
enough to power 
the Pi Zero from a 
single USB port if 
wired to the GPIO 
pin 2 or 4. 
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NES CONSOLE-TROLLER 


•prqfcrf 

dc&a 


CATEGORY: 

Entertainment 

DIFFICULTY: 

Advanced 


USB NES 
controller 

Micro-USB male 
connector 

Solder 

Drill 

Retro Pie 

magpi.cc/ 

iHVgNba 


THINK OF 
IT LIKE... 


The originator 
of the ‘console 
in a controller’ 
concept - popular 
at Christmas, but 
a bit limited once 
you’ve played 
every possible 
variation of Pong 
and Asteroids 





NES 

CONSOLE-TROLLER 


hile we’re big fans of the educational mission 
; y\f of the Raspberry Pi project, and we fully 
support it of course, we’d be lying if we 
said we don’t love to use the Pi for entertainment 
as well. Whether it’s the Pi we have stuck to the 
back of the TV for streaming media, or gaming with 
RetroPie, the Pi is well suited to these uses. So when 
we first heard of the Pi Zero, we thought of all of the 
great hacks that Ben Heck has done over the years, 
and we realised that the Pi Zero could perfectly slot 
into a USB NES controller. With a bit of creative 
wiring, it could be made into a fully functional games 
console that exists entirely in the controller itself. 

The USB NES controllers all have a standard USB 
cable; this provides enough power to the controller so 
that the individual button presses can be registered. 

In order to repurpose the controller, begin by snipping 
off the original USB cable that pokes out of the rear 
of the unit. You can now solder the wire to a male 
micro-USB port. This way, you can use the hole for 
the trailing USB cable for the mini-HDMI cable. 

You’ll need to find a cable that has a relatively short 
connector. Alternatively, you could drill the hole 
larger to accommodate it. 

The only thing remaining to make the whole 
thing work is to give the Raspberry Pi power. You’ll 
either have to drill a second hole so that you can 
plug the power cable in, or you may be able to use 
the original hole depending on the design of the USB 
NES controller you have and how the mini-HDMI is 
mounted. Alternatively, you could try binding the 
USB and HDMI cables together; in this case you will 
need to use a television with a USB port that will 
provide adequate power. 


We bought 
this NES controller 
from eBay: we had 
to file down the 
plastic a little bit 
to slot in the Zero 


Once all the hardware is complete, you can then set 
up RetroPie (magpi.cc/iHVgNba) on a microSD card. 

If you have a spare Raspberry Pi lying around, it might 
be best to get the initial setup sorted on there first 
before plugging it into your NES controller to set the 
buttons. Remember that you only have the buttons 
which exist on an NES, so make sure any games you 
put on there don’t require more than you have. 

Finally, plug it into a TV and have some fun! 
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PRINT YOURSELF A 



PI ZER0 CASE 


/ e Ve taken the liberty of designing and 
y\f preparing a 3D-printable Raspberry Pi Zero 
case for all our readers. It’s quite simple, but 
gives you access to all the important ports to get to get 
it working, and it will handily slot onto a keyring so you 
can take it with you. 

Find all the 3D printable files in the GitHub repository 
(magpi.cc/ZeroCase) and then plug them into your own 
3D printer, get one printed at your nearest makerspace, 
or use 3D Hubs (3dhubs.e0m) to find a local printer who 
will get it printed for you. Enjoy the rest of the issue! 


Print your 
own Pi Zero case 
with our design; it 
has our name on it! 


Get the 

'3D printable 

files here! 


magpi.ee/ 
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ZeroCase 





Pi»DigiAMP+ 

* Raspberry Pi HAT, no soldering required 

* Fuil-HD Audio (up to 24bit/l92MHz) 

* Texas Instrunnents TAS5756M 

* Up to 2x35w of stereo amplification 

* Out-of-the-box Raspbian support 

^ integrated hardware volume control 

* Provides power to the Raspbeny Pi 

- Software mute on GPI022 

- i/0 {(2c. 3v, 5v. Ov, GPI022/23^24/25) 

- Just add speakers for 3 complete Hi-Fi 

* input voltage t2-l9v 

* Supports speakers from 4-8ohm 
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Pi-DAC+ 


^ Raspberry Pi HAT, no soldering required 

- Full-HD Audio {up to 24bit/192MH2} 

^ Texas Instruments PCM5122 

- Variable output to 2 1 v RMS 

“ Headphone Amplifier / 3.5mm socket 

• Out-of-the’box Raspbian support 

• Integrated hardware volume control 

• Access to Raspberiy Pi GPIO 

• Connect to your own Hi-Fi's linefin/aux 

• Industry standard Phono (RCA) sockets 

• Supports the Pi-AMP+ 


Pi-AMP+ 


• Pi-OAC+ accessory, no soidenng required 
- Full-HD Audio (up to 24bit/192MHz) 

■ Texas Instruments TPA311S 

■ Up to 2x35w of stereo amplification 
^ Provides power to the Raspberry Pi 
' Software mute on GP1022 

• Auto-Mute when using Pi-DAC+ headphones 

• Input voltage 12-19v 

• Supports Speakers from 4-8t3hm 


piCorePlayer 

QCJUtrtr^lir AtJt ■! 


rune audio 


Twitter: @IQ_au(jio 
Email: infD@iqatjdio.com 


WWW.IQAUDIO.COM 


IQaudio Umited. 
Swindon, Wiltshire. 
Company No.; 9461908 












SAVE 
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SUBSCRIPTION 
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This subscription is: H For me H A gift for someone* 
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Get six issues: 

£30 
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Subscribe for a year: 

£55 
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magpi.cc/Subsi (UK - ROW) 
imsnews.com/magpi (US) 

Call +44 (0)1202 586848 
Use the form to the right 

Available on the 
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Get it on 
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fryecb 


SHOWCASE 


MAGIC 
MIRROR 



BRADLEY MELTON 

A network engineer and aspiring 
'professional geek' who Loves to use 
and sing the praises of the Raspberry Pi. 

imgur.com/A4kjx7w 


Mirror mirror on the wall, what’s 
the weather going to be like today? 
Should I bring an umbrella? 

O t’s amazing how the Iron 
Man films have inspired 
people due to the way 
they portrayed almost-attainable 
technology. Watching someone 
look over sunny Malibu while the 
weather info was displayed right 
in front of them was a great visual. 
It’s not exactly brand new, unseen 
technology - cars have been 
projecting HUDS onto windscreens 
for a while now - but it has never 
been popularised in a major 
blockbuster before. While we 
don’t seem to have quite reached 
the stage of the incredible glass 
tech of Tony Stark’s bedroom just 
yet, apparently we’re close enough 
to get mirrors working in the same 
way, or at least Bradley Melton has 
managed it with his Magic Mirror. 

^dt’s called a ^Magic Mirror’, 
but a more accurate name would 
be a ^Smart Mirror’,” Bradley tells 
us. ^dt’s a mirror that displays the 
information you need to know at 
a quick glance: the time, the 
date, the weather, and of course 
a compliment!” 

It’s not the first mirror of its 
type, and Bradley admits that he’s 
taken some cues from a previous 
project by Michael Teeuw (see more 
details about it on Michael’s blog: 
magpi.cc/iPzFbWa), taking the 
concept and bringing it down to 
a more beginner level for himself 
so he could learn more about 
web development. 

^^Plus, because 1 know what each 
and every function does and how it 


The project 
is made with 
Google Coder 

It took a week 
to do the frame, 
a few days for 
the code 

This is Bradley's 
first creative 
Pi project 

In the past, he 
has used Pis in 
his home Cisco 
networking Lab 

The online 
community 
helped a Lot to 
get this to work 



It's an extra-useful mirror 
as it displays up-to-date 
weather information taken 
from the internet 


It Looks Like a mirror, but it's 
actually a cunning disguise - 
a monitor, and some two-way 
glass covered by a frame 




Monday 


72° September 28»2i®tS 

iiL 5:22 pm 




If I had to Choose between Mr.^fogers; and you, i 
would be V ■ 


Of course, a mirror should 
also be able to reflect your 
image and make sure you’re 
Looking good 
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frqecb 



Magtc Mirror 


A TECH REFLECTION 


0^ 

4:00 pni 


k> 


>STEP-01 


>STEP-02 


>STEP.-03 


Keep me updated 

Everything works on a timer, so the 
weather and time are updated on the 
browser window that makes up the display 
every 15 seconds, while the compliment 
is updated every 30 seconds. 


Turn the mirror on 

Turning the display on activates the 
Raspberry Pi, which is powered via a 
USB port on the mirror itself. It boots into 


Getting the doto 


The weather info is taken from Yahoo 


scraped using the simpleWeather.jsjQuery 
plug-in which then displays the weather on 
the display. Time is displayed as well, along 
with a compliment. 


the Chromium web browser, which is 


displayed on the screen 


works, it makes it easier to fix bugs 
as well as make improvements 
in the future/^ 

Rather than use an actual mirror 
and project the data upon it, the 
Magic Mirror uses a widescreen 
monitor that has been put in a 
portrait orientation with an acrylic 
two-way mirror on top. With the 
right lighting and display tweaks. 


^dt’s not very complex,’^ 

Bradley informs us. As long as 
you have a little bit of carpentry 
or DIY skill to build the frame 
and have a basic understanding 
of how to program, you should 
be able to build this. 1 have never 
used JavaScript or CSS before this 
project, and 1 only had a little bit 
of experience with HTML, but this 


I Rather than use an actual mirror 
and project data upon it, the Magic 
Mirror uses a widescreen monitor 


If 


it can be reflective enough to use 
as a mirror while also displaying 
the weather data. The electronics 
are fairly simple: it’s just a Pi with 
HDMl linking to the mirror, a WiFi 
dongle to retrieve online data, and 
a USB cable to the monitor as well, 
which is how it draws its power. 

To finish it off, Bradley built a 
wooden frame to be laid over the 
bezel so that the whole thing was 
camouflaged a bit better. 


webpage is built almost entirely 
from JavaScript and CSS.” 

At the time of writing, 
the mirror has been running 
for a few weeks without any 
problems. It seems like Bradley 
wants to include some holiday- 
themed extras to it, starting with 
some spooky additions for the 
Halloween just past. We’re hoping 
he will add some jollier ones for 
the Christmas period. 



Above Say 'Bloody Mary’ three times into the mirror 
on Halloween for a voice-activated fright 
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fryecb SHOWCASE 


A spectacular sculpture. 
SeeMore is also a functioning 
parallel computer comprising 
256 Raspberry Pi Model B+s 




( 125 ^ f 7? 
lf.fi 


Each Pi is connected to a 
servo that moves its arm, and 
therefore panel, outwards in 
proportion to its workload 








8 7 2 




VIRGINIA TECH 

SeeMore was created via a collaboration 
between the School of Art and Department 
of Computer Science at Virginia 
Polytechnic Institute and State University 
by teams Led by Sam Blanchard and Kirk 
Cameron respectively 


Each plastic panel is •— 

etched with the IP address 
for the Pi mounted upon it 1. 


The articulating arms are 
designed with a double 
linkage to create a fluid 
‘waveform’ movement 




hr 








S'- ^ 


580Lb {263kg) 
of high-density 
plastic was 
used in the 
construction of 


It comprises 
1,280 moving 
parts and 
7,312 pieces of 
hardware 

1,320ft (402m) 
of extruded 
aluminium was 
used to create 
the framework 

SeeMore's 
construction 
involved 60 
hours of CNC 
machining 
and 80 hours 
of volunteer 
assembly 

It takes around 
one and half 
days to wire 
it all up, using 
1,536ft (468m) 
of USB cable 
and 2,200ft 
(670m) of 
Ethernet cable 


THE PI-POWERED PARALLEL 
COMPUTING SCULPTURE 

Powered by a cluster of 256 Raspberry Pis, Virginia Tech’s 
stunning kinetic sculpture gives a visual representation 
of how parallel processing works 


O tanding nine and a half 
feet tall, the SeeMore 
sculpture-cum- 
supercomputer suddenly whirrs 
into life, its green translucent 
panels sliding fluidly outwards 
in mesmerising waves across its 
spiral surface, delivering a physical 
representation of the computations 
being performed. Resembling 
something from a science-fiction 
movie, SeeMore is powered by a 
network of 256 Raspberry Pi Model 
B+s; one is attached to each plastic 


panel, whose articulating arm 
swings outwards whenever that 
particular Pi is actively working on 
a parallel computing task. 

The idea for SeeMore originated 
in 2013 when Virginia Tech (vt.edu) 
computer science professor Kirk 
Cameron was working on a 32- 
node Raspberry Pi cluster in his 
lab. Seeking a way to help more 
people understand the concept of 
parallel computing, he approached 
his colleague Sam Blanchard, 
assistant professor of sculpture. 


to help create an interactive art 
installation for that purpose. Since 
Sam’s main area of interest lies in 
robotic creations, he immediately 
suggested making a kinetic 
sculpture that responds to what’s 
going on inside the computer. 
^^LCDs are cool,” explains Sam, 
^^but you can really get a visceral 
reaction from people by showing 
them something that is moving. . . 
and has a presence in a space.” 

Sam tells us that the cylindrical 
design of SeeMore was partially 
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BUILDING A KINETIC SCULPTURE 



Custom-made ports Articulating arms Bending metal 


The components for the mechanisms Assembled from several components. 256 Since the team couldn’t find anyone to 

were all custom-designed by Sam using articulating arms were required for the full- bend the T-slot aluminium to create the 

PartWorks CAD, then cut from acrylic scale version of SeeMore. Each features a arcs for SeeMore’s framework, they had 

sheets using a ShopBot CNC machine. In double linkage that results in a fluid, curved some special rollers made for a bending 

this photo Sam is making support brackets movement of the plastic panel holding the Pi machine, as used here by Virginia Tech 

for the sculpture’s metal framework. when triggered. sculpture student Robert Redfearn. 


inspired by the classic Cray-i 
supercomputer of the mid to late 
1970s, a time when computers were 
far from being boring black boxes. 
^^They had a physical presence, 
almost like a sculpture or a piece of 
furniture,’^ says Sam. Indeed, the 
Cray-1 even had a bench around it 
so that people in the office could 
sit and have their coffee! While 
SeeMore lacks a seating facility, 
its footprint is proportional to 
that of the Cray-i, although it’s 
almost twice as big and also has an 


The power of parallel 

This transparency of design ties in 
perfectly with the project’s main 
aim of helping the general public 
to visualise how parallel computing 
works and emphasise the important 
work of high-performance computing 
researchers. As Kirk points out, we all 
benefit every day from the advances 
made in large-scale systems that 
are essential to the infrastructures 
of services like Google, Twitter, 
and Dropbox. ^Wet, the general 
population that relies on these 


I SeeMore was partially inspired by 
the classic Cray-1 supercomputer 
of the mid to late 1970s 


hourglass shape to it. In addition, 
an early design decision was taken 
to deliberately expose all SeeMore’s 
workings, including the combined 
2,736 feet (834m) of wiring, in 
much the same way as the Cray-i. 
^^One thing 1 really appreciated 
about that form was that it 
had this interior space and an 
exterior facade and so it was very 
transparent in the way that you 
could not just literally see through 
it but walk around and see [all the 
wires and workings],” reveals Sam. 


technologies doesn’t understand 
the importance and the elegance 
innate to what folks like us do. By 
using aesthetics and visualisation, 
my idea was to impart the most basic 
information such as the fact that we 
use lots of devices collectively and 
in parallel to solve problems larger 
than those we can solve with a single 
system. The algorithms you see on 
SeeMore represent synchronous and 
asynchronous communications and 
collaborations common in parallel 
codes and systems.” 



The original panels were replaced with green translucent ones 
for the 2015 World Maker Faire in New York City 
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SHOWCASE 


frcjeclA 



Above Each panel When SeeMore was exhibited 

proport“n°to its recently at the World Maker Faire 
Pi‘s workload in New York City, it was set up with 

a local open-source database to 
enable users to search (via a custom 
touchscreen) for points of interest 
around a given subway stop. Kirk 
tells us that multiple steps are 
required to for such a task. ^^The 
first is to break this problem into 
smaller sub-tasks such as having 
each Pi search part of a very large 


database of points of interest. In 
this example, the Pis in our cluster 
would be assigned portions of a 
database to search and all of them 
would be given the same subway 
stop as their hoken’ to use in the 
search. This divide-and-conquer 
approach is a common algorithm 
used in parallel computing and 
this example is similar to the 
algorithm used in Google search 
and demonstrated on SeeMore.’^ 


Scaling it up 

Having started out with a modest 
budget, the project was gradually 
scaled up via three prototype 
stages, which used first one 
Raspberry Pi, then nine, and then 
30 (see Prototyping process’ 
boxout). Extra funding was 
subsequently provided by the 
National Science Foundation and 
Virginia Tech’s own Institute for 
Creativity, Arts and Technology, 
which enabled it to be scaled up to 
the final 256-node version. 

SeeMore’ s mechanisms were 
all custom-made and designed by 
Sam, and their design evolved over 
time. Most notably, the articulating 
arms that move the panel-mounted 
Pis were designed specifically to 
create a more fluid effect. ^Phe 
movement of the Raspberry Pis is 
actually a curve. . . so it doesn’t just 
flap out, it articulates outward,” 
says Sam. ^Rt has a double linkage 
that some might see as superfluous, 
or overly complex, but 1 think that 
what you get. . . is this waveform 
that relates to these ideas of fluidity 
and that springs from what a lot 
of parallel computers are built 
to process: things like weather 
simulation or fluid dynamics.” 



i 


>STEP-04 


>STEP-05 


Assembling the frame 

The metal framework’s circular sections 
are made up of two arcs for easier 
assembly. Furman power blocks screwed 
into the frame supply the electricity via 
wall-warts with twin USB ports to power 
each Pi and servo separately. 






Servos galore 

256 Hi -Tec HS-7966HB servos are used to 
move the articulating arms and therefore 
the attached Raspberry Pi panels. When 
exhibiting SeeMore at an event, the team 
have spare components on standby just in 
case anything should fail. 


>STEP-06 


Plastic panels 

Each plastic panel is etched with that Pi’s 
IP address. Networking them together isn’t 
that great a challenge since all the Ethernet 
cables run down to the inner base, where 
they can be connected (in any order) to six 
48-port Ethernet switches. 
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SEEMORE 


frqecb 


Also, rather than moving straight 
to its maximum 90-degree outward 
position when triggered, each 
panel moves in proportion to the 
percentage of computing capacity 
being used by the respective 
Raspberry Pi. To achieve this, 
each Pi is linked to its arm’s 
servo via a GPIO pin. While in the 
prototype designs, the servo also 
received its power from the Pi, a 
switch from the original Pi Model 
B to the B+ for SeeMore’s final 
version necessitated that both be 


hours machining those pieces,” 
laughs Sam. He tells us that this 
provided students with many hours 
of milling experience. 

The plastic panels are all laser-cut 
and etched with the IP address of 
the attached Pi in two places, so they 
can be seen whether the panel is flat 
or has moved out. Having started 
out with blue and clear panels, the 
team changed them to a translucent 
green for the New York Maker Faire. 

like the idea of customising the 
project for where we show it. ” 




The logistics of exhibiting 
SeeMore at an event involve it 
being transported in six crates 




powered separately. Not wanting 
to overcomplicate the design 
with battery packs or external 
power supplies, Sam ended up 
buying PSUs with two USB ports so 
separate cables could be run to the 
Raspberry Pi and its servo. 

On the software side, Kirk tells us 
that the combination of controlling 
the servos and running a full OS on 
the Pis led to complications. ^Wor 
example, there is a software stack 
or a series of tools that we typically 
install on top of the operating 
system across the whole cluster. 

In the Pi environment, combining 
this stack with the servo controls 
and synchronising the movement 
of the Pis to running tasks was 
challenging... there is not a lot 
of community software support 
available since this had never been 
done. Thus, we created a lot of 
custom software to make this work 
in a visually compelling way. ” 

Custom components 

The arms themselves comprise 
a number of pieces made from 
HDPE (high-density polyethylene) 
plastic, milled out on a ShopBot CNC 
machine. These had bronze bearings 
inserted, all using steel shafts cut by 
the team. ^^Almost every single piece 
is custom: some people assume 
we bought those off the shelf, but 
1 can assure you we spent many 


The logistics of exhibiting 
SeeMore at an event involve it being 
transported in six crates and then 
assembled at the location. ^^My 
students and 1 show up three days 
ahead of time,” says Sam. Once the 
framework’s rings - which are split 
into two for shipping, with Pis still 
attached - are put back together, 
there’s a day and a half of wiring to 
be done. ^Bt’s one guy on the outside 
and one guy on the inside, and then 
you’re just passing wires to each 
other. It’s actually pretty loose in 
there and 1 like to keep it that way: 

1 like how the wires move on their 
own inside the structure.” While 
routing all the USB power lines 
correctly is a major challenge, Sam 
tells us that getting the Pi network 
connected is less problematic 
since the cables are connected to 
six 48-port Ethernet switches in 
SeeMore’ s base, so it doesn’t matter 
which ports they’re plugged into. 

Although the overall assembly 
process is arduous, the end result 
is certainly spectacular, attracting 
a crowd of visitors at the couple 
of events at which SeeMore has 
appeared so far. Sadly, Sam tells us 
there’s no suitable space at Virginia 
Tech to keep SeeMore in assembled 
form, so it’s currently back in its 
crates, but there are plans to exhibit 
it again in 2016. Watch this space 
for more news. 



PROTOTYPING 

PROCESS 


Before scaling up to the final full-scale version of 
SeeMore, three prototypes were created... 


Prototype 01 

The first basic prototype featured a single Raspberry 
Pi connected to a metal articulating arm powered by 
a servo. This was then given to the computer science 
department to test the software. 


Prototype 02 

With nine Raspberry Pis mounted on a flat framework, 
the team had to figure out how to wire them up to 
avoid any tangling. The computer science department 
created a nine-node parallel computing algorithm. 







Prototype 03 

Scaling things up, 30 Raspberry Pis were mounted on 
transparent HDPE panels, while the articulating arms, 
framework, and wiring system were similar to those 
used in the final full-scale sculpture. 
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Tutorial , walkthrough 


EVERYDAY 

ENGINEERING 


PART 10 



SIMON MONK 

Simon Monk is the author of 
the Raspberry Pi Cookbook and 
Programming the Raspberry Pi: Getting 
Started with Python, among others. 

simonmonk.org 

monkmakes.com 






PIPE 

TEMPERATURE 

MONITOR 


USB WiFi adaptor 
An accurate DS18B20 



'You’U 

fleed 

> Encapsulated 
DS18B20 
(eBay, Adafruit, 
Proto Pic) 

> 47k resistor 
(often supplied 
with DS18B20) 

> Three-way screw 
terminal block 

> 3x female-to- 
male jumper 
wires 

> USB WiFi 
adaptor 

> Small food 
container as 
an enclosure 

> Drill 


F 


Solve real-world electronic and engineering problems with your Raspberry Pi 
and the help of renowned technology hacker and author, Simon Monk 


O t this time of year, our roof spaces can get 
pretty chilly and if there are pipes up there, 
there is a chance they could freeze. As anyone 
who’s put a bottle of wine in the freezer to cool and 
then forgotten about it knows, ice takes up more space 
than water and can burst pipes as it expands. This is 
often only discovered when the ice thaws again and 
your bedroom has water dribbling through the ceiling. 

This project monitors the temperature of your pipe 
and uses the If This Then That (IFTTT) web service to 
alert you by email or other mechanism of your choice 
if the temperature falls below a threshold that you set. 

IFTTT is a web service that allows you to set up 
triggers that then cause an action. For example, you 
could create an IFTTT ^Recipe’ that sends you an 
email (Action) whenever someone mentions you on 
Twitter (Trigger). As well as actions and triggers from 
all sorts of social media and email services, IFTTT can 
also be set up to work with physical events like the 


temperature measured by a temperature sensor falling 
below some threshold. 

The way this works is that the Raspberry Pi sends 
a web request to IFTTT as a trigger and then IFTTT 
performs whatever action you have specified for it. 

In this case, the trigger is to send an email. 

The various channels available to IFTTT often 
require their own logins, so IFTTT will from time 
to time ask you to enter a user name and password 
for a particular channel. 


^WARNING! 

Do not rely solely on this project to protect your pipes 
from frost. This is a DIY project intended to illustrate the 
principles of making a temperature monitor and is in no 
way guaranteed to protect your home. 
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PIPE TEMPERATURE MONITOR 



DS18B20 is a digital I 
device, accurate to I 
±0.5 degrees C I 

As youdl see from the list of required components, 
this project does not call for any soldering. The 
leads to the temperature probe are connected to 
the Raspberry PI GPIO pins using a combination of 
electrical terminal block and female-to-male jumper 
wires. You will find the screw terminal block at any 
DIY or hardware store that sells electrical supplies. 

DS18B20 temperature sensor 

The DS18B20 is a sensor temperature chip that is 
available in a standard 3-pin transistor-like package, 
or built into an encapsulated sensor with a long lead. 

In this project we chose the encapsulated version, 
but you could also use the 3-pin package version on 
a breadboard. The chip requires there to be a 4.7kQ 
resistor between its data and positive supply pins. The 
chip itself will work with 5V or 3.3V logic, but you must 
connect the positive supply to 3.3V when using it with 
a Raspberry Pi to prevent damage to the Pi GPIO pin 
that it is connected to. 

Temperature sensors are often quite inaccurate, 
but the DS18B20 is a digital device that is accurate 
to ±0.5 degrees Gelsius. 

The 1 C uses a single GPIO pin on the Raspberry Pi 
using an interface called the i-wire. Temperature 
readings are sent as serial data to the Raspberry Pi. 

Building your pipe monitor 

As with all projects, it is a good idea to run a test and 
get everything working while the parts are all out on 
your workspace. Once you know all is well, you can 
install the project in its enclosure. 


II 




>STEP-01 

Connect female header leads 

Put the red (positive supply), black (ground), and yellow (data) wires from 
the temperature probe into the screw terminal, with the leads of the 
resistor between the red and yellow wires. You may find it helps to wrap the 
bare ends of the wires around the resistor leads before tightening up the 
screw terminals. 

Fit the male ends of the jumper wires into other half of the terminal block. 
Your probe lead may also have a separate bare wire connector to the 
lead’s screening; you do not need to connect this to anything. 


>STEP-02 

Cannect the temperature sensar 

Connect the positive supply lead to the 3.3V GPiO pin. the black ground 
lead of the sensor to one of the GND pins on the GPiO header, and the 
data lead to GPiO 4. Using a GPiO pin template such as the Raspberry 
Leaf makes it much easier to find the right pins. 

We used a food container that would hold both the screw terminal 
and the Raspberry Pi and drilled holes for the USB power and sensor 
leads. The knot in the sensor lead is to stop the connections being 
pulled off. and the electrical tape prevents the resistor leads 
from accidentally shorting anything on the GPiO pins. ^ 


BUILDING THE PROJECT 


This is a pretty straightforward project to build. There is no soldering to 
be done, although if you have a soldering iron, tinning the ends of the 
wires from the sensor leads to make them a bit thicker makes it easier 
to catch them in the terminal block. 
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Tutorial 


WALKTHROUGH 


ifrhi thenthat 


>STEP-03 

Start a new recipe in IFTTT 

If you don’t have one already, 
create yourself an account on 
IFTTT (ifttt.com). Then click on 
the Create a Recipe button. 



>STEP-04 

Create a Maker Channel Trigger 

Click on the IF part of the new 
recipe and search for the Maker 
Channel in the list of channel icons 
that is shown. Select the only 
trigger option available (Receive 

a web request) and enter the 

text ‘pipe.alert’ into the Event 
Name field. 

>STEP-05 

Choose an Action 

Now we come to the THAT part of 
IFTTT. So, click on THAT and select 
the Email action channel, and then 
select ‘Send me an email. This 
will use the email address that 
you specified when you signed 
up to IFTTT. 

Complete the action fields. 

The ‘subject’ field will become the email subject, and the body field 
will contain the text of the email. Notice the use of the special names 
contained between {{ and 11. These are called ‘ingredients’ and allow 
you to customise the text. In this case, the ‘OccuredAt’ is a timestamp 
for when the trigger event happened, and ‘valuei’ will contain 
the temperature. 



C « . - 
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if V then □ 


>STEP-06 

Complete the Recipe 

After you have completed the 
Action, you will return to a 
summary of the Recipe. Click the 
Create a Recipe button to actually 
create the recipe and make 


Th« Mifew ■protno ^ 
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>STEP-07 

Find your secret key 

Bad things could happen if Just 
anyone were allowed to trigger 
emails to be sent using IFTTT. 

So when the web request is sent 
from Python to trigger the email, it 
must be accompanied by a secret 
key. To find that key, click on the Channels tab at the top of the IFTTT 
webpage and then find the Maker channel. 

In a little while, you are going to need to paste the secret key into your 
Python program. 


This is the kind of project that you definitely want to 
use SSH for, so that you can connect to the Raspberry 
Pi remotely using the WiFi USB dongle. You can find 
instructions on setting up your Pi to use SSH on the 
official website: magpLcc/iGULinTr. 

Before you can use the DS18B20 temperature sensor, 
you need to enable the i-wire interface of the Raspberry 
Pi. To enable i-wire, edit the file /boot/config.txt using 
the command: 

sudo nano /boot/config.txt 

Add the following line to the end of the file: 

dtove r lay =wl - gpio 

Now reboot your Raspberry Pi and i-wire should 
be enabled. 

You can download the program for this project from 
your Raspberry Pi command line using: 

git clone https://github.com/simonmonk/ 
pi_magazine.git 

Before running the program, open it with the nano 
editor and change the line: 

KEY = "cyR3vPNFlP9K32W4NZB9cd" 

Change this to the IFTTT key that you found earlier. Run 
the program as superuser using the command below: 

sudo python pipes. py 

When you run the program, you should see the 
message ^Monitoring’ in the terminal, after which 
temperature readings should start appearing. 

How the code works 

The Python code for this program is commented. You 
will probably find it handy to have the code up in an 
editor while we go through it. 

The program starts by importing the libraries that 
it requires: 

glob is used to find the device file for the temperature 
sensor, as the program needs to use wild-card matching 
because every DS18B20 is given a different device ID 
during manufacture; 

time is used for delays; 

urllib and urllib2 are used to send the web 
request to IFTTT. 

You may well want to change the constants that 
follow this, especially while you are testing the system. 
The variable ALAR|vi_TE|viP sets the temperature at which 
an alarm will be triggered, so set this to a few degrees 
less than the temperature reported by the program 
in the terminal and go and get yourself a glass of cold 
water for testing. 
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PIPE TEMPERATURE MONITOR 


The constant |V1IN_T_BETWEEN_WARNINGS prevents 
messages being sent more frequently than once every 
hour. You might want to change this while you are 
testing the project. 

The next set of variables are used to identify the 
location for the file of your particular temperature 
sensor. This will be in the folder /sys/bus/wi/devices/, 
but then the folder name after this will be different for 
every DS18B20. 

The function read_temp reads the content of the 
device file. This will be a two-line message from the 
temperature sensor that looks something like this: 


fipe3.py 

import glob 
import time 

import urllibj urllib2 


>PYTH0N 


ALARM_TEMP = 5.0 # degrees C 
MIN_T_BET1 aIEEN_1aIARNINGS = 60 # Minutes 
EVENT = 'pipe_alert' 

BASE_URL = 'https://maker.ifttt.com/trigger/' 

KEY = 'cyR3vPNFlP9K32lAl4NZB9cd' # Place your own key here 


28 01 4b 46 7f ff 08 10 4c : crc=4c YES, 

28 01 4b 46 7f ff 08 10 4c t=18500 

The number at the start of both lines is the unique 
ID for the DS18B20, and the first line ends in YES if the 
reading was successful, with the temperature being 
reported at the end of the second line as the number of 
thousandths of a degree C. In this case, that’s i8.5°C. 

The function read_temp extracts the temperature value 
from the message and returns it. 

The send_notification function constructs a URL for 
the IFTTT web service, providing the temperature in the 
request body. 

The main loop repeatedly reads the temperature, to 
check if it has fallen low enough to trigger an alarm. 

If so, it calls send_notification and then delays until 

|V1IN_T_BETWEEN_WARNINGS minutes have passed. 

Using your pipe monitor 

To test the project before you install it, set 
ALARM_TEMP to a couple of degrees lower than the 
ambient temperature, then put the sensor into some 
cold water. After a few moments, the temperature 
readings will start to fall until you get a message: 

TEMPERATURE WARNING 
Congratulations! You^ve fired the 
pipe_alert event 

If you go and check your email inbox, you should see a 
notification message. 

Even the power-efficient Raspberry Pi generates 
enough heat to provide a misleading temperature 
reading. To avoid this, make sure that the DS18B20 is 
well away from the Raspberry Pi itself, ideally near or 
even taped to the pipes that you are trying to protect. 

You will of course also need somewhere to connect a 
power adaptor, and make sure that your roof space is not 
out of range of your WiFi router. 

This is a project that lends itself to other tasks. 

You could modify it to just report the temperature at 
regular intervals, or to check for temperatures getting 
too hot rather than too cold. You can also pick other 
actions from IFTTT, such as tweeting or sending 
aFacebook update. 


# These constants used by the 1-wire device 
base_dir = ' /sys/bus/wl/devices/ ' 
device_folder = glob.glob(base_dir + '28*')[0] 
device_file = device_folder + '/wl_slave' 

# Read the temperature message from the device file 
def read_temp_raw() : 

f = open(device_file, 'r') 
lines = f .readlinesO 
f .closeO 
return lines 

# Split the actual temperature out of the message 
def read_temp(): 

lines = read_temp_raw() 
while lines[0] .strip()[-3: ] != 'YES': 
time.sleep(0.2) 
lines = read_temp_raw() 
equals_pos = lines[l] .find( ' t= ' ) 
if equals_pos != -1: 

temp_string = lines[l] [equals_pos+2: ] 
temp_c = float (temp_string) / 1000.0 
return temp_c 

# Send an IFTTT pipe_alert event 
def send_notification(temp) : 

print ("TEMPERATURE WARNING") 

data = urllib.urlencode({ ' valuel' : str(temp)}) 

url = BASE_URL + EVENT + '/with/key/' + KEY 

response = urllib2.urlopen(url=url, data=data) 

print(response.read()) 


print ("Monitoring") 
while True: 

temp = read_temp() 

print(temp) 

if temp < ALARM_TEMP: 

send_notification(temp) 

time . sleep (MIN_T_BETWEEN_WARNINGS 


60) 


NEXT MONTH 

In the next project in this series, you'LL Learn 
how to use your Raspberry Pi to control a 
Mi-Lite wireLess-controLLed LED Light buLb. 
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Tutorial 


STEP BY STEP 



ROB ZWETSLOOT 

Tech writer, avid coder, and Raspberry 
Pi enthusiast with a history of building 
many things with Raspberry Pi. 
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Nice big Lights are easy 
to solder on and use 
within the code as well 


The board slots neatly over 
the Raspberry Pi - it will 
completely cover an A+! 


USE THE TRAFFIC HAT 


WITH GPIO ZERO 


^ouU 

Heed 

> Traffic HAT 

magpi.cc/ 

iMmazoD 

> GPIO Zero 

magpi.cc/ 

iMmajnP 

> Soldering iron 
(optional) 


As one of the boards that GPIO Zero supports, the Traffic HAT 
is a perfect way to show off the library... 


he Traffic HAT is a great little kit: a GPIO- 
mounted add-on for the Raspberry Pi that 
makes learning how to program for physical 
computing a little easier and bit more fun, along with 
nice big components that can also help you learn the 
basics of soldering. 

With the release of GPIO Zero, the Traffic HAT is 
now easier than ever to program, whether you want to 
use it manually or make use of the handy Traffic HAT 
function built into GPIO Zero. Follow along with us as 
we teach you how to make the most of both the HAT 
and GPIO Zero. 

>STEP-01 

Prepare the Traffic HAT 

You can buy the Traffic HAT pre-soldered so that you 
donh have to worry about it, but it’s a great beginner 
kit for learning how to solder. You only need to install 




Above We wrote the code on a computer and moved it to the 
Raspberry Pi, but there’s no difference from writing it on the Pi itself 



the main features you’ll be using: the three LEDs, the 
push-button switch, and the buzzer. 

Make sure to follow the outline guides on the board 
as to how to place them. The buzzer’s positive side is 
indicated on the component, and the board also has a 
guide showing which side it should be attached to. The 
LEDs should be soldered so the flat edge of the bulb 
meets the flat edge of the outline. 

>STEP-02 

Install the Traffic HAT 

Make sure your Raspberry Pi is turned off. Slot the 
HAT over the GPIO pins, with the board itself lying 
across the Raspberry Pi. This way, it shouldn’t be 
poking over the edge like a plank and will look like a 
normal addition to the Pi. 

Once that’s done, you can turn on your Raspberry Pi. 
Once booted up into Raspbian, you’ll need to install 
GPIO Zero. This can be done by using the following 
commands in the terminal: 

sudo apt-get install python-pip python- 
wlthermsensor python-spidev 

sudo pip install gpiozero 

>STEP-03 

Basic GPIO Zero 

The LEDs have a GPIO number attached, as do the 
button and buzzer. We can use that in conjunction 
with GPIO Zero to activate the LEDs manually in the 
GPIO Zero style. Open up a new Python script in IDLE 
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USE THE TRAFFIC HAT WITH GPIO ZERO 



Above You can also install the GPIO Zero software under Python 3; 
in fact, it’s recommended by the creator. However, you’ll need to 
change the print lines in our code 


and start it with the following code, so it knows what 
functions to use: 

from gpiozero import LED 

Then write in the following so the red LED, 
connected to GPIO 24, lights up: 

led = LED(24) 
led. on 

Press F5 to run it and see the results. Buzzer and 
Button are the other functions that you can import 
for the Traffic HAT. 

>STEP-04 

Dedicated GPIO Zero 

A slightly easier way of programming the Traffic HAT 
with GPIO Zero is by using the actual Traffic HAT 
function built into Zero. You can make use of it by 
changing the first import line to: 

from gpiozero import TrafficHat 

This makes use of buzzer, button, and lights 
functions to manage those respective parts of the 
HAT. The lights are then described as green, amber, 
and red in the code, for when you want to activate 
them. WeTl now create a little script to perform a 
traffic light sequence in Python. 

>STEP-05 

Setting up 

Looking at the code on this page, we have a simple 
setup by importing TrafficHAT and time. WeTl need 
the latter to simulate the kind of delay you normally 
get on real traffic lights. Set the Traffic HAT code 
to be known as the variable th and wehe ready to 
begin our loop. 

Create a simple while loop that will continuously 
run. Start it by having the green light show, and use 
another while loop to stop the code until the button is 
pressed. It will stay green forever unless you press the 
button or interrupt the program. 


Trqffuf^ghts^y 

from gpiozero import TrafficHat 
from time import sleep 

th = TrafficHatO 


>PYTHON 


try: 

while True: 

# Traffic light code 

# Firstj turn the green LED on 
th. lights. green. on 0 

print "Press the button to stop the lights!" 

# Nextj we want to wait until the button is pressed 
while(th . button . is_pressed == False): 

ttWhile not pressed do nothing 
pass 

# Button has been pressed! 
th . lights .green .off ( ) 

# Amber on for a couple of seconds 
th. lights .amber .on 0 

sleep(2) 

th . lights . amber . of f ( ) 

# Turn the red on 
th . lights . red .on( ) 

# Buzz the buzzer 20 times with 0.1 second intervals 
th . buzzer .blink (0. 1,0. Ij 20, False) 

sleep(l) 

th . lights . red . off ( ) 

# Red off and blink amber 4 times with 0.5 second intervals 
th . lights .amber .blink (0. 5,0. 5,4, False) 

except Keyboardinterrupt : 
exit() 


A GPIO add-on that makes 
learning how to program for 
physical computing a little easier 

>STEP-06 

Light timing 

The bit of code after the button is pressed may 
seem a little complicated at first glance, but under 
closer inspection it should be fairly straightforward. 

It emulates the way traffic lights work at a pelican 
crossing, activating the amber light for a few seconds 
before giving a steady red light. 

When the red light appears, the buzzer will 
beep for a few seconds before the red light is 
turned off and the amber appears, this time 
flashing itself, before reverting back to green. 

At this point, the while loop starts again, waiting 
for a button prompt. 
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1 3 D viewer 


Miniature tripod 


^ouU 

fieed 

>Thin self- 
adhesive acrylic 
mirrors (IKEA 
sells them) 

> 5mm foam 
mounting board 

>V^"UNC 
half nut 

>6mm thick MDF 
- 220 X 63mm 

> Miniature tripod 

> Hot-melt glue 


See 3D images on your Raspberry Pi monitor - through a viewer, 
through a 3D monitor, or with nothing added 


O igital imaging offers many options for both 
taking and viewing stereoscopic images, and 
here we present three variations on how to 
view them. First, there is the wiggle method, where 
the left and right image are flashed alternately on 
the screen at a slow rate; while not spectacular, it 
does give an impression of 3D. At the other end of 
the spectrum is using a 3D TV for a monitor on the 
Raspberry Pi; this involves displaying the pictures side 
by side, turning on the 3D SBS (Side By Side) mode 
of the TV, and donning your glasses. What we will 
concentrate on here is making a unique 3D viewer, 
but software for the other two methods is on GitHub 
as well. Note that not everyone can see the effect: 
only 95% of people are able to perceive the 3D in 
images presented in this way. 

The project 

A stereoscopic image is created by taking two images 
about 75mm apart to simulate those received by each 
of your eyes, but the images are taken from a slightly 
different angle. To view this, you need to feed each of 
those images into a separate eye. There are quite a few 
ways of doing this, but the main problem with using 


an ordinary monitor is simply that our eyes are not far 
apart enough to make it work without a lot of painful 
optic muscle contortions. The solution is to extend 
the distance of the image by using a pair of horizontal 
miniature periscopes. 

The project consists of slide show software and a 
viewer comprising four mirrors mounted on a plate. 
This should be attached to a miniature tripod and set at 
a height equal to halfway up the screen. It should be set 
at a distance away from the monitor that’s comfortable 
for your eye focus. The slide show software displays 
full-screen images that can be in two file formats. The 
viewing program will display all the images in a user- 
selectable folder, advancing the image on a key press 
or automatically after a set period. 

The stereoscopic file formats 

There are two formats that the software can handle. 
The first is a normal JPEG image, but with the left 
and right images placed side by side. This sort 
of file might have a file extension of .jpg or .jps, 
which are essentially the same thing; however, 
the .jps extension tells you to expect a side 
by side stereoscopic image. 
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The second is an MPO file that many cameras with 
a stereoscopic capability produce. This file basically 
contains two JPEG images; in fact, if you change the 
file extension from .mpo to .jpg, you will be able to see 
the first image with any JPEG viewing application. The 
trick in displaying the second image is to find where 
it is: there’s nothing in the file header that will tell 
you it immediately follows the end of the first JPEG. 
However, Python doesn’t make that easy to do, and the 
only strategy for finding that second image is to search 
for it by looking for the JPEG header sequence of bytes 
Tf d8 ff ei’ . A sure-fire way is to look from the start 
of the file, but this is going to take some seconds for a 
large file. You might think that halfway through the file 
might be a good place to start, seeing that the MPO file 
has some specific MPO metadata in it before the images. 
However, the left and right images are not the same 
size. You might think that since the images have the 
same dimensions, they’d have the same size file, but in 
fact they are slightly different images and they compress 
into different sizes. We checked about 20 files and found 
that while most second images were over halfway, a few 
were just under. We settled on starting the search at 
0.49 of the way through the file, which seems to work 
for most things. 

The screen display 

Having isolated the individual images in the file, they 
have to be scaled down to fit the screen and placed in 
the correct location. The centre of each image must be 
placed halfway along the Y axis, and one-quarter and 
three-quarters of the way along the X axis. To cope 
with different screen sizes, the operating system must 
be asked what size of screen is being used in terms 
of pixels. 

We are using the Pygame framework for this, in a 
mode not often used: full-screen mode. This is tricky 
to work with, because any errors result in the system 
freezing. To get round this, there is a nearly full- 
screen mode that has just the window bar showing; we 
used this for debugging till all errors were eliminated, 
then the full-screen mode could be used. The debug 
mode is defined by a Boolean variable. The full-screen 
must be disabled before you can choose a folder 
containing the images to show in the slide show, and 
then full-screen mode can be restored for the display. 

The code 

The listing overleaf shows the version of the program 
for use with the viewer described in the ^Building 
The Project’ section. It has variables that control the 
swapping of the left and right images in both the side 
by side files and the MPO files if needed. The space bar 
is used to bring up a window to navigate to a folder to 
display; choosing any file in the folder shows all the 
images in turn. The up and down arrow keys put the 
viewer into and out of the hold mode, and the left and 
right arrow keys switch to the next or last displayed 


BUILDING THE PROJECT 



220mnn 



>STEP-01 

Making the 3D viewer 

The actual dimensions will depend on the size of your monitor. The outer 
two mirrors must be apart by half the width of your screen, whereas the 
centre of the inner two mirrors must be as far apart as your eye pupils, 
which is normally 75mm. We made the dimensions to suit our 15" TV 
monitor; if you are using a bigger one, make the outer mirrors further 
apart and larger. Don’t worry if they are too big: you can always use black 
insulating tape to cut down the field of view to just half the screen. 




>STEP-02 

Make the base piate 

Cut the MDF to size and drill two holes for the tripod mounting: 8mm for 
the thread, and 4mm for that alignment pip found on a lot of tripods. You 
will note from our pictures we didn’t make it long enough and the outer 
mirrors protruded over the side; this is no problem, but a full base makes 
it more robust. In the 8mm hole, hammer a UNF thread half nut and 
glue it in place; this will act as the receptacle for the tripod. 

Use a half round hole and take the edge ofF the sheet where 
your nose will be; your nose will thank you for this later. 
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>STEP-03 

Make the mirrors 

Cut out two 6o X 40mm pieces of foam mounting board for the outer 
mirrors, and two 30 x 40mm pieces for the inner mirrors, then cut pieces 
out of the acrylic mirrors to match. Use a sharp knife, or better still a 
scalpel, to make the cuts. With the mirrors, it’s best to score both front 
and back and snap them. Then peel the adhesive backing ofF the mirrors 
and fix them to the mounting board; keep the clear plastic mirror covers 


on for the time being. 



>STEP-04 

Fixing mirrors to the board 

Mark up the base with the lines to align your mirrors and remove the clear 
plastic film protecting the surface. Use hot-melt glue to fix the two inner 
mirrors; a miniature try square will help you get these vertical. Then fix 
the outer mirrors one at a time. You can do it by eye, adjusting the vertical 
angle of the mirror as the glue sets. This is what we did; however, after we 
made it we thought of a much better way of aligning the mirrors, using 
a laser line from a pointer or DIY level to make sure everything lines up. 
Finally, cut and glue the blocking piece between the two inner mirrors. 


# View3D - full screen slide show 

# By Mike Cook Dune 2015 

import pygame 

from pygame. locals import * 
import time, os 

from cStringlO import StringlO 

from Tkinter import Tk 

from tkFileDialog import askopenfilename 

pygame. init() 

pygame . event . set_al lowed (None) 

pygame . event . set_al lowed ( [ pygame . KEYDOWN, pygame . 

QUIT]) 

debug = False 

screen = pygame.display.set_mode((0, 0)) 

# with window bar - use for debugging 
if not debug : 

pygame . display . toggle_f ullscreen ( ) 
pygame. display. set_caption(" 3D Slide Show") 
xs, ys = screen. get_size() 
backl = pygame. Surf ace( screen. get_size()) 
erase = pygame. Surf ace( screen. get_size()) 
backl = backl. convert 0 

displayTime = 4.0 # seconds to show each image 

hold = False 

advance = False 

back = False 

newList = False 

sbsSwap = False # swap left and right on sbs files 
mpoSwap = False # swap left and right on MPO files 
Tk() .withdrawO 

def main() : 

global newList, hold, advance, back, imageList 
getFolderO # get the directory to show 
newList = False 
interval = time.time() 
while True: 
image = -1 

while image < len(imageList)-l : 
checkForEventO 
if newList: 

newList = False 
break 
image += 1 

fName = imageList [image] 
ext = fName[len(fName)-3:len(fName)] 
if ext== "mpo" or ext == "MPO": 
processMPO(fName) 

interval = time.time() + displayTime 
elif ext== "jpg" or ext == "IPG" or 
ext== "jps" or ext == "DPS": 

processSBS (fName) 

interval = time.time() + displayTime 
if hold : 

# hold = image on for 1 hour 



image. The displayTime variable sets how long an 
image is shown - when in the hold mode, this is 
extended to an hour. 

other versions 

If you go to the GitHub repository, you will find 
two other variations of this code. The first is called 
ViewBDWiggle.py; this scales both images to the full 
size of the screen and then displays them alternately 
in quick succession. This gives an impression of the 
stereoscopic view, and we have found it works better 
on some images than others. 

The other version is called ViewsDsbs.py and is 
designed for use with 3D monitors. While this is very 


similar to the version used with the viewer, the scaling 
is different. With the side by side view, the images are 
scaled with the correct aspect ratio. However, when 
a 3D TV goes into a side by side mode, it pulls half 
the screen into a full screen. So, to compensate for 
this, the scaling of the images’ aspect ratio has to be 
Vrong’ in order to look right in the 3D mode. 

Getting the images 

There are many cameras that claim to be able to 
produce a 3D image; most do this by getting the user 
to scan across the scene, and the software takes two 
samples to create a left and right image. This is fine 
for scenes with little or no movement, but not much 
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interval = time.time() + 3600 

while time.timeO < interval : # wait for slide 
checkForEventO 
if advance or newList: 
advance = False 
interval = time.time() 
if back : 

back = False 

image -= 2 # set picture back 
if image < 0 : 

image = len(imageList)-l 
interval = time.time() 

def processMPO(name) : # process an MPO image 
with open(namej ' rb' ) as imgfile: 

imgbuf = StringIO(imgfile.read()) 

imagel = pygame. image. load (imgbuf) 
statinfo = os.stat(name) 
fileSize = statinfo. st_size 

# print "file length of'^ name, "is", statinfo. st_size 
with open (name, ' rb' ) as imgfile: 

imgbuf 2 = StringIO(imgfile.read()) 

jpegFound=0 

# speed up search 

startSeek = int (float (fileSize) * 0.49) 

imgbuf 2. seek(startSeek) 

# startSearch = time.time() 

while jpegFound < 1 and startSeek < fileSize: 
fb= imgbuf 2. read (4) 
imgbuf2.seek(-3, os.SEEK_CUR) 
if fb == "\xff\xd8\xff\xel": 

jpegFound +=1 
startSeek += 1 

if jpegFound == 1: 

imgbuf 2. seek(-l, os.SEEK_CUR) 
image2 = pygame. image. load (imgbuf 2) 
if mpoSwap : 

scale_show(image2, imagel) 
else: 

scale_show(imagel, image2) 

else : 

print "no second image found in", name 

def processSBS(name) : # process a side by side image 
root Image = pygame. image. load (name) 
xi, yi = rootImage.get_rect() .size # size of image 
imagel = pygame.Surface(((xi/2),yi)) 
image2 = pygame. Surface(((xi/2),yi)) 
imagel. blit (rootimage, (0,0)) 

image2.blit(rootImage, (0,0), ((xi/2),0, (xi/2),yi)) 
if sbsSwap : 

scale_show(imagel, image2) 
else : 


good otherwise. Better cameras have two lenses 
and capture two individual images. The best one of 
these is the Fuji Real 3D, but sadly this is no longer 
produced, although you can still pick them up new on 
eBay. We have made a camera rig with two identical 
cheap cameras bolted together, and that can work 
quite well. 

Many MPO files can be found on the internet. 

The 3DS handheld games console can take and 
display images; these are only small and so decode 
very quickly. One excellent source is the website 
mathpirate.net/3DS; these are larger-format 3D 
images scaled down to 3DS format, so are much better 
quality than you can take on the console. 
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scale_show(image2, imagel) 



def scale_show(imagel,image2) : 
global screen, backl 
scale = 1.0 

xi, yi = imagel.get_rect() .size 

# size of the image 

if xi> xs or yi > ys: # scaling needed 

scalex = float (xi) / float ((xs-60)/2) 

# -60 to give a gap in the centre 

scaley = float(yi) / float(ys/2) 
scale = scaley 
if scalex > scaley : 
scale = scalex 
newX = int(float(xi) / scale) 
newY = int(float(yi) / scale) 


>PYTH0N 2.7 
DOWNLOAD: 

magpi.cc/iNqJjmV 

PROJECT 

VIDEOS 

Check out Mike's 
Bakery videos at: 

magpi.cc/iNqJnTz 


r 


imagel = pygame. transform. scale( 

imagel, (newX,newY)) # scale the image 
image2 = pygame. transform. scale( 

image2, (newX,newY)) # scale the image 

imRec = imagel.get_rect() .size # get scaled size of the image 
ofsetY = (ys/2) - (imRec [l]/2 ) 
ofsetXl = (xs/4) - (imRec [0]/2) 
ofsetX2 = (3*(xs/4))- (imRec[0]/2) 

# print "offset", ofsetX, ofsetY 

backl. blit(erase, (0,0)) 

backl . blit (imagel, (of setXl, ofsetY) ) 

backl . blit (image2, (of setX2, ofsetY) ) 

screen. blit (backl, (0,0)) 

pygame. display, flip 0 

def getFolder(): # get the list of pictures to show 
global imageList, newList, screen 
if not debug: 

pygame . display . toggle_f ullscreen ( ) 
filename = askopenfilename() 
path = os.path.dirname(filename) 

imageList = [os.path. join(path,fn) for fn in next(os.walk(path))[2]] 
list. sort (imageList) # put in alphabetical order 
newList = True 
if not debug: 

pygame . display . toggle_f ullscreen ( ) 

def terminate(): # close down the program 
print ("Closing down please wait") 
pygame . mixer . quit ( ) 
pygame. quit 0 # close pygame 
os._exit(l) 

def checkForEventO : # see if we need to quit 
global hold , advance , back 
event = pygame. event. poll () 
if event. type == pygame. QUIT : 
terminateO 

if event. type == pygame . KEYDOWN : 

if event. key == pygame . K_ESCAPE : 
terminateO 

if event. key == pygame. K_SPACE : 
getFolderO 

if event. key == pygame. K_UP : 
hold = True 

if event. key == pygame . K_DOWN : 
hold = False 

if event. key == pygame . K_RIGHT : 
advance = True 

if event. key == pygame. K_LEFT : 
back = True 

# Main program logic: 

if name == ' main ' : 

# try: 

main() 

# except : 

# terminateO 
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SAM AARON 

Sam is the creator of Sonic Pi. By day he's 
a Research Associate at the University of 
Cambridge Computer Laboratory; by night 
he writes code for people to dance to. 

sonic-pi.net 


MUSICAL MINE CRAFT 


This month Sonic Pi creator, Sam Aaron, makes much more than just music... 


O n the previous tutorials, weVe focused 
purely on the music possibilities of Sonic 
Pi, which can turn your Raspberry Pi into a 
performance-ready musical instrument. So far, weVe 
learned how to: 

Live-code, changing the sounds on-the-fly 
Code some huge beats 
Generate powerful synth leads 
Recreate the famous TB-303 acid-bass sound 

There’s so much more to show you (which we will 
explore in future editions). However, this month, let’s 
look at something Sonic Pi can do that you probably 
didn’t realise: control Minecra/t. 

Hello Minecraft World 

OK, let’s get started. Boot up your Raspberry Pi, fire 
up Minecraft Pi, and create a new world in it. Now 
start up Sonic Pi, and resize and move your windows 
so that you can see both Sonic Pi and Minecraft Pi at 
the same time. 

In a fresh buffer, type the following: 

mc_message "Hello Minecraft from Sonic Pi!" 

Now, hit Run. Boom! Your message appeared in 
Minecraft! How easy was that? Now, stop reading this 
^^^sages ^ moment and play about with your own messages . 

to MinecrafV. Have f un 1 


^ouU 

Heed 

> Raspberry Pi 
running Raspbian 

> Sonic Pi V2.6+ 

> Speakers or 
headphones with 
a 3.5mm jack 

> Update Sonic Pi: 
sudo apt-get 
update && sudo 
apt-get install 
sonic-pi j 



Sonic teleporter 

Now let’s do some exploring. The standard option is 
to reach for the mouse and keyboard and start walking 
around. That works, but it’s pretty slow and boring. 

It would be far better if we had some sort of teleport 
machine. Well, thanks to Sonic Pi, we have one. Try this: 

mc_teleport 80, 40, 100 

Crikey! That was a long way up. If you weren’t in flying 
mode, then you would have fallen back down all the way 
to the ground. If you double-tap the space bar to enter 
flying mode and teleport again, you’ll stay hovering at 
the location you zap to. 

Now, what do those numbers mean? We have three 
numbers which describe the coordinates of where 
in the Minecraft world we want to go. We give each 
number a name: x, y, and z: 

X - how far left and right (80 in our example) 
y - how high we want to be (40 in our example) 
z - how far forward and back (100 in our example) 

By choosing different values for x, y, and z, we can 
teleport anywhere in our world. Try it! Choose different 
numbers and see where you can end up. If the screen 
goes black, it’s because you’ve teleported yourself under 
the ground or into a mountain. Just choose a higher 
y value to get back out above land. Keep on exploring 
until you find somewhere you like. 

Using the ideas so far, let’s build a Sonic teleporter 
that makes a fun teleport sound whilst it whizzes us 
across the Minecraft world: 

mc_message "Preparing to teleport...." 
sample :ambi_lunar_land, rate: -1 
sleep 1 

mc_message "3" 
sleep 1 

mc_message "2" 
sleep 1 

mc_message "1" 
sleep 1 

mc_teleport 90, 20, 10 
mc_message "Whoooosh I " 
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Magic blocks 

Now you Ve found a nice spot, let’s start building. You 
could do what you’re used to and start clicking the 
mouse furiously to place blocks under the cursor. Or you 
could use the magic of Sonic Pi. Try this: 

X, y, z = mc_location 
mc_set_block : melon, x, y + 5, z 

Now look up: there’s a melon in the sky! Take a 
moment to look at the code. What did we do? On line one 
we grabbed the current location of Steve as the variables 
X, y, and z. These correspond to our coordinates 
described above. We use these coordinates in the 
function mc_set_block, which will place the block of 
your choosing at the specified coordinates. In order to 
make something higher up in the sky, we just need to 
increase the y value, which is why we add 5 to it. Let’s 
make a long trail of them: 

live_loop :melon_trail do 
X, y, z = mc_location 
mc_set_block : melon, x, y-1, z 
sleep 0.125 
end 

Now, jump over to Minecraft, make sure you’re in 
flying mode (double-tap the space bar if not) and fly all 
around the world. Look behind you to see a pretty trail of 
melon blocks! See what kind of twisty patterns you can 
make in the sky. 

Live-coding Minecraft 

Those of you that have been following this tutorial 
over the last few months will probably have your minds 
blown at this point. The trail of melons is pretty cool, 
but the most exciting part of the previous example is 
that you can use live_loop with Minecra/t! For those 
who don’t know, live_loop is Sonic Pi’s special 
magic ability that no other programming language 
has. It lets you run multiple loops at the same time 
and allows you to change them whilst they run. They 
are incredibly powerful, and amazing fun. 1 use 
live_loop to perform music in nightclubs with Sonic 
Pi: DJs may use discs, but 1 use live_loop instead! 
However, today we’re going to be live-coding both 
music and Minecraft. 


Let’s get started. Run the code above and start 
making your melon trail again. Now, without stopping 
the code, just simply change : melon to : brick and 
hit run. Hey presto, you’re now making a brick trail. 
How simple was that! Fancy some music to go with it? 
Easy. Try this: 

live_loop :bass_trail 
tick 

X, y, z = mc_location 

b = (ring :melon, : brick, :glass).look 

mc_set_block b, x, y -1, z 

note = (ring :el, :e2, :e3).look 

use_synth :tb303 

play note, release: 0.1, cutoff: 70 
sleep 0.125 
end 


Now, whilst that’s playing, start changing the 
code. Change the block types: you could try : water, 

: grass, or your favourite block type. Also, try 
changing the cutoff value from 70 to 80 and then up 
to 100. Isn’t this fun? 

Bringing it aii together 

Let’s combine everything we’ve seen so far with a little 
extra magic. We’ll combine our teleportation ability with 
block placing and music to make a Minecraft music video. 
Don’t worry if you don’t understand it all: just type it in 
and have a play by changing some of the values whilst 
it’s running live. Have fun, and see you next time. . . 


live_loop :note_blocks do 
mc_message "This is Sonic Minecraft" 
with_fx : reverb do 

with_fx :echo, phase: 0.125, reps: 32 do 
tick 

X = (range 30, 90, step: 0.1). look 
y = 20 
z = -10 

mc_teleport x, y, z 

ns = (scale :e3, :minor_pentatonic) 

n = ns. shuffle, choose 

bs = (knit :glass, 3, :sand, 1) 

b = bs.look 

synth :beep, note: n, release: 0.1 
mc_set_block b, x+20, n-60+y, z+10 
mc_set_block b, x+20, n-60+y, z-10 
sleep 0.25 
end 
end 
end 


live_loop : beats do 

sample :bd_haus, cutoff: 100 
sleep 0.5 
end 
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SEAN M TRACEY 

Sean is a technologist Living in the South 
West of England. He spends most of his 
time making silly things with technology. 

sean.mtracey.org 


% ^ THE ALIENS 
% ^ ARE HERE 



& THEY'RE 
I COMING 
WAVES! 



This is the final part of our Pygame series. We’re going to give the space 
shooter game we started in the last issue some extra polish 


O ello everyone! Welcome back to the final part 
of this making games with Pygame series. It’s 
been ten months! Gosh, you’ve been patient - 
thanks for sticking with us. Haven’t we had some great 
times? Though soon we’ll part ways, for a little while 
at least, now is no time to get weepy - WE HAVE ALIEN 
HORDES TO FINISH DECIMATING, PEOPLE! So let’s get 
down to it. 

If you look over the code from the last issue and 
compare it to the code for this issue, you’ll see that, 
despite having the same foundations, there’s quite a bit 
more going on in the code this time around. Last time 
we dealt with creating a start screen, moving our ship, 
firing our weapons, creating enemies, having them 
fire their weapons, and then removing them from time 
and space whenever we hit one another. This time, 
we’re going to add shields to our spaceship and create 
a simple health/shield bar to show their status. We’re 
also going to write some code that lets us create levels 
and waves for our enemy spaceships to fall into, as well 
as writing some logic for announcing that the next level 
of bad guys are on their way. Finally, we’ll create two 
end screens: one for if the aliens kill us, another for if 
we survive all of the levels of the onslaught. 


A tour at warp speed 

We’ve seen most of this code before, obviously, but a 
good deal has changed, so we’re going to zip through 
where those changes are before we look at them in 
more detail. 

Let’s look at the key differences of aliens. py first... 

On line 7 of aliens. py, we now import another file, 
gameLevels.py. This file contains a list with a bunch 
of dictionaries that we’ll use to place our enemies 
in the different levels of our game. It’s a big file, 
but it’s not a complicated one, and we’ll take a look 
at that shortly. 

On lines 24-29, we have some new variables. We’ll 
use these to keep track of our game’s progress and 
state, as well as changing levels. 

On lines 39-42, we load a couple of extra images 
to use in our game; these will be our game over and 
wave announcement graphics. 

We’ve done away with the lastEnemyCreated 
variable we used last time to generate enemies 
after a certain time interval. Instead, we now have 
a launchWave method that will unleash a group 
of enemy spaceships, based on the pattern we 
pass it from our gameLevels.py file. updateGame 
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has changed quite a bit from last time, but that’s 
because we’re just making it a little better at what 
it does already. 

On lines 151 and 152 we now draw a bar across the 
bottom of our game screen, showing our shields 
and health status. As either our shields or health 
decrease, these bars will shrink. 

In ships. py, we’ve not changed very much at all; 
we’ve just added a tiny bit of logic that creates and 
draws some basic shields for us. This will be the 
first thing we take a look at in detail, so we won’t 
examine it here. 

Finally, in projectiles. py, we’ve added a 
checkForHit function. We know what you’re 
thinking: ^^Wait, we have that function in the code 
for our spaceship; why do our projectiles need them 
too?” Well, you might have noticed in the previous 
game that when you destroyed an enemy spaceship, 
the lasers it had fired would disappear along with 
the ship. This was because each ship was responsible 
for looking after and updating the bullets it had 
fired... no ship, no bullets. With this function, and 
a little bit of code in aliens. py, we can give the 
projectiles a place to live after their ship has been 
destroyed, so that they may enact terrible vengeance 
on our spaceship. 

Full power to the forward 
deflector shields! 

Let’s start with the simple things first: what 
does every spaceship need? A kettle, obviously, 
but also energy shields to keep it safe from 
cosmic dust and enemy fire alike. Both are a 
nightmare for paintwork! 

Implementing shields for our ship isn’t too difficult 
(we don’t have time to install a kettle, regrettably). 
We did most of the work already when we created 
health for our ships. If you look at lines 9, 10, 21 
and 22 of ships. py, you’ll see we’ve created four 
new variables, shieldlmage is where we’ll load 
the image that we’ll use to draw our shield. It’s just 
a transparent PNG which we draw over our ship 
when it’s been hit, to give a cool bit of feedback to 
our players. drawShield is set to True whenever 
our ship is hit, so we can draw the shield only when 
we need to instead of the whole time, shields and 
maxShields are next, shields is the current amount 
of shield strength we have, and maxShields is the 
maximum amount of shield energy we’re allowed to 
have. Every time our shields are hit, we decrease the 
shield energy by 1, so we can sustain three hits to our 
shields before our ship starts to take damage. To let 
our shields take the brunt of enemy fire before they 



start to damage our ship, we’ve tweaked our register 
hit function inside of our ship class. Previously, our 
registerHit method, when called, would decrement 
(decrease by one) our health value until it was 0. Now, 
it will check if we have any shield energy left; if our 
shield levels are greater than 0, we’ll decrement the 
shield level instead of the health level, and we’ll set 
our drawShield variable to True so we can draw the 
shields. If our shields are at 0, then we decrease the 
health value just like we did before. Simple, eh? When 
our ships draw( ) method is called, it will check 

We have that function in the 
code for our spaceship; why do 
our projectiles need them too? 

whether or not our drawShield function is True. If it 
is, we must have taken a hit, so we’ll draw the shield 
and then set drawShield to False so it will disappear 
until we’re hit again. 

While we’re on the subject of shields and health, 
let’s look at where we create health and shield bars. 

Back in aliens. py on lines 151 and 152, we draw a 
rectangle for our health and another for our shields. 

It’s quite a long line of code, but it’s quite simple 
really. For shields, we take the maximum amount 
possible that a shield can be (3) and divide the width 
of the game window (gameWindow) by it; we then 
multiply that value by the current shield level. This 
gives us the width that our shield bar needs to be to 
show the amount of energy we have left. If we can 
sustain three more hits, the bar will be full across 
the width of our game screen; if it can take two hits, 
it will fill two-thirds of the screen, and so on until it 
is empty. We do the exact same thing for our health 
bar; we just don’t affect the values until our shields 
are depleted. 


QUICK TIP 

If you know how 
to use a difF tool, 
comparing the 
aliens.py code 
from part 10 
with part 9 will 
really help you 
get a complete 
oversight of what 
we've changed 
and why. 


II 


Above There are 
two different types 
of shield for this 
game: a bubble 
shield. Like the USS 
Enterprise has. 
or a shape shield 
(which we think 
looks cooler), like 
those found in 
Stargate. You can 
change them by 
Loading the image 
you prefer in the 
ships class 
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Above A visual 
representation 
of how we can 
determine enemy 
spaceship positions 
using a matrix 


Below 

By adjusting 
patterns and 
intervals, you 
can make levels 
completely 
different from one 
another with very 
little effort 


Let's take a look at o matrix 

The biggest change in this version of our game is 
that we can now define levels and formations for our 
enemy ships to attack us with. If you take a look at 
gameLevels.py, youTl see there is only one variable, 
level. This is a dictionary that contains objects which 
describe our levels. Our first level or Vave’ is the first 
dictionary, the second level is the second dictionary, 
and so on. Each level dictionary has two properties: 
interval and structure. Let’s take a look at the 
structure property first: this is a list of lists, and 
in each list is a series of is and os. Each list is a wave. 
Think of structure as a map of our game window. 

The width of our game window is represented by one 
list inside of structure. Eor each i in our list, we want 
to create an enemy spaceship in corresponding space in 
our game window, and for every o we don’t. Using this 
approach, we can define levels of different difficulty and 
appearance, just by changing the values of structure. 
For example, if we wanted to create ten ships that 
spanned the width of the screen at equal intervals, 
we’d add a list like this to our structure list: 



If we wanted that row of ships to be followed by a row 
of six ships with a gap in the middle, we’d add two lists 
to structure - one for the first row of spaceships, and 
another for the second: 

This structure is known as a ^matrix’, which you 
can think of as a list with an X and Y axis (sort of). If 
you wanted to know whether or not we were going to 
create a spaceship in the second grid down from the 
top of our screen and three across, you could check 
with levels[0] .structure[2] [3], but that’s not 
quite how we’re using this in our game. 

The other property of our level objects is interval. 
This value sets how many seconds should pass before 
we move on from one wave and create the next. 
Tweaking this value can greatly change the difficulty 
of each level. For example, if you have five waves of 
enemies with a 5 second interval between each row, 
you’ll have ten spaceships being generated every 5 
seconds that you need to destroy. That’s quite a lot, but 
50 enemies over 25 seconds is pretty easy to deal with 
- after all, we’re awesome. However, if you create ten 
rows of ships and set the interval between waves to 2 
seconds, you’re going to be dealing with 100 ships in 
20 seconds! That’s an onslaught. To illustrate this, the 
final level included in gameLevels.py contains five 
times the number of waves than any other level, but 
there is only one ship in each wave and the interval 
is 0.5 seconds. This creates a zigzag pattern of ships, 
which makes for interesting gameplay when you’re 
being fired at by ships across both the X and Y axes. 
With this knowledge, you can create a limitless variety 
of levels for our game; all you have to do is copy one 
of the level objects, and edit the structure and interval 
as you see fit. That’s much more fun than spawning 
enemies at random X/Y coordinates. 
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Launch wave! 

So, now that we know how to structure our levels, how 
do we put them together in our game? Back in aliens. py 
we have the launchWave() function. This takes the 
current level and wave, and generates enemies at the 
correct positions and correct time for our game. At the 
end of our ^main’ loop, we have a tiny bit of code on 
lines 222 and 223 that checks how long it’s been since 
a wave of enemies has been spawned. If more time has 
passed than is allowed by our interval value for the 
current level we’re playing, launchWave is called. 

The first thing launchWave does is create the 
variable thisLevel. We don’t have to do this, but it 
makes what we’re trying to do a little more obvious 
when we access our level structure, rather than using 
gameLevels.level[currentLevel] ["structure"] 
every time. Next, we check that the wave we’re about 
to create actually exists in our level. If our level has four 
waves and we try to access a fifth one, our game will 
crash. If the wave we want to access does exist, we take 
that wave and assign it to the thisWave value. Again, 
this just makes our code a little nicer to read. We then 
work through the values of that wave. 

First, on line 64 of aliens. py, we check whether or 
not we want to place an alien spaceship here (1) or not 
(0). If we do, we then do a little bit of maths to work 
out where to place it. First, we divide the windowWidth 
by the length of the list that makes up the wave; 
we then place the ship at the X coordinates that are 
windowWidth / the number of slots in the wave * 
the index of this ship. So, if we have ten slots in this 
wave, and each one wants to have a ship created in 
each slot, launchWave will create ten enemies at equal 
distances across the width of the game screen. If every 
other slot in that ten was a 0 and didn’t want to have 
a ship drawn, then five ships would be drawn at equal 
intervals across the game screen. 

Once launchWave has created the enemies it needs 
to, it lets the game continue on its way until it’s called 
by our main loop again. If, the next time launchWave 
is run, it finds that there are no more waves in this 
level, it will check to see if there’s another level it can 
move on to. If so, it will recharge our ship’s shields, 
increase the level number, and reset the wave number 
to 0. New level! If launchWave finds that it’s run out of 
waves to create and that there aren’t any more levels 
to play, it assigns the gameWon variable to True. This 
is a preliminary value, as nothing will happen until 
all of the enemies have been destroyed, either by our 
bodacious laser blasts or by them simply flying off the 
screen to their oblivion. If we survive all of the levels 
and aren’t destroyed by a lucky potshot from one of 
our alien foes, then we’ve won the game! Hurrah! 
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other tweaks and tidbits 

We mentioned earlier that we’d added a checkForHit 
function to our projectiles.py Bullet class. Let’s talk 
about why we need this for a moment. In a perfect world 
where everyone owns a Raspberry Pi and wants to use 
it exclusively for making Pygame games, every object 
in a game is responsible for handling itself inside of 
the larger context of the game. When a projectile hits 
a target, it runs all of the code it needs to run and then 
removes itself from the game. Unfortunately, the world 
is not an ideal place; each object in our Pygame shooter 
is aware of itself and can interact with the things we 
tell it to, but they can’t be responsible for removing 
themselves from the game when they’re no longer 
useful, so we need a little bit of code that decides for 


Above A visual 
representation 
of how we map 
the matrix to the 
dimensions of our 
game window 


I 


The first thing launchWave does 
is create the variable thisLevel 


II 


US. In part 9, we had each ship be responsible for each 
bullet that it fired; as such, each ship kept a reference 
to all the projectiles it had fired in a list accessed with 
self .bullets and this was a great solution... kind of. 
Each ship was responsible for cleaning up its own mess; 
makes perfect sense, right? Well, yes, so long as there is 
a ship to clean up after itself. But we destroy spaceships 
- Earth needs defending, and if nobody else is going to 
do it, we’ve got to step up - and when we destroy the 
enemy spaceships, what happens to bullets they’re 
responsible for? Yup, they get destroyed too, which 
doesn’t make sense because the bullet left the ship a 
long time ago. It’s a bit like a car catching fire in a car 
park because there’s a blaze in the kitchen back home: 
the two are related, but not inextricably connected. 

So how do we go about solving this? By taking over 
responsibility for orphaned projectiles, of course! On 
line 48 of aliens.py, we have leftOverBullets. This 
is an empty list. When an enemy is removed from our 
game (because we’ve destroyed it or some other reason), 
just before we delete the reference, and any reference 
to the enemy ship’s projectiles entirely, on lines 114- 


QUICK TIP 

Just because 
you’re following a 
tutorial, it doesn’t 
mean you have 
to use all of the 
resources we 
provide. Why 
not tweak some 
of the images 
to create your 
own unique 
spaceship? Or 
mess around 
with the level 
structures and 
ships classes to 
create more than 
one enemy ship? 
Learning comes 
from trying these 
things out and 
seeing how far 
you get! 
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Above The two 
different game over 
screens: one for 
victory and one we 
hope we never see 



pr^jectUe3.py 

class Bullet(): 

X = 0 
y = 0 

image = None 
pygame = None 
surface = None 
width = 0 
height = 0 
speed = 0.0 

def loadlmages(self) : 

self. image = self .pygame. image. load(self. image) 
def draw(self ) : 

self .surface. blit(self.imagej (self.x^ self.y)) 

def move(self): 

self.y += self. speed 

def checkForHit(self j thingToCheckAgainst) : 
if self.x > thingToCheckAgainst .X and self.x < 
thingToCheckAgainst .X + thingToCheckAgainst .width: 

if self.y > thingToCheckAgainst .y and self.y < 
thingToCheckAgainst .y + thingToCheckAgainst . height : 
thingToCheckAgainst . registerHit ( ) 
return True 

return False 

def init (self^ x^ y^ pygame^ surface^ speedy image): 

self.x = X 
self.y = y 

self. pygame = pygame 
self. surface = surface 
self. image = image 
self .loadImagesO 
self. speed = speed 

dimensions = self .image. get_rect() .size 
self. width = dimensions[0] 
self. height = dimensions[l] 

self.x -= self. width / 2 


117 of aliens.py we go through the bullets array of each 
enemy we’re about to delete and append a reference to 
each bullet to our leftOverBullets list. Now, when 
we delete our enemy ship, we can still animate, move 
and update the bullets each ship has fired, by iterating 
through the leftOverBullets list and checking 
whether or not our stray projectiles have hit anything. 
This leads us back to checkForIt in the Bullet class. 
With the enemy ship removed from the game, so too 
is the method we were using to detect the hits. By 
including a simple version in Bullet that returns True 
or False when a collision is or isn’t detected, we can 
continue to use our game without having to change a 
great deal of the logic. 

As mentioned previously, we have more than one 
game over screen: one for if we’re victorious against the 
alien scourge, and one for if we’re not so fortunate. In 
order to know which one to show at the completion of 
the game/demise of our ship, we have a new variable: 
gameWon. This is set to True when our launchWave 
function works out that there are no more waves/levels 
for it to create. Setting gameWon to True is not cause to 
consider the game Von’ - even though there are no 
more new enemies to create, there may still be some 
left over that could destroy our player, so it’s not until 
gameWon is True and the number of enemyShips is o that 
we show the congratulations screen. If we’re destroyed 
before the number of enemy ships is o, gameWon is set to 
False and gameOver is set to True, meaning we show the 
loser screen. 

One last little thing: on line 15, we have our familiar 
old surface statement - except, if you compare it to 
previous versions, it’s got an extra argument, 
pygame . FULLSCREEN. Guess what that does? Enjoy! 

That's all, folks! 

And that’s it! That’s this series over, finished, finite, it is 
an ex-series, excuse us while we grab some tissues. You 
should now be able to go out into the world and make 
simple video games using Python, a Raspberry Pi, and 
Pygame. Let’s quickly go through all of the things we’ve 
learned off the top of our heads throughout 2015. We’ve 
learned how to draw basic shapes; how to use a keyboard 
and mouse to move, create, and delete things; we’ve 
learned all about gravity (or at least, a super- simple 
version of it); we’ve learned how to bounce things off 
of other things and how to register things hitting one 
another; we’ve learned all about playing sounds and 
blitting images; and tons and tons of stuff about Pygame 
and system events. We’ve also learned that Python is 
lovely and really good for getting up and going from 
scratch, for beginners and experts alike. In short, it’s 
been a blast and your expert has loved every minute of it. 
See you guys around! 
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01. level = [ 83 ^ 


02. 

{ 














84. 

03. 


"structure" : 

[ 

[0. 

1, 0, 1 

0, 1 

0, 1 

0, ^ 

L]. 


85. 

04. 





[1. 

0. 

1. 

0. 

1. 

0. 

1. 

0. 

1. 

0]. 

86. 

05. 





[0. 

1, 

0. 

1, 

0. 

1. 

0. 

1. 

0. 

1]. 

87. 

06. 





[1. 

0. 

1. 

0. 

1. 

0. 

1. 

0. 

1. 

0]. 

88. 

07. 





[0. 

1. 

0. 

1. 

0. 

1. 

0. 

1. 

0. 

1]. 

89. 

08. 





[1. 

0. 

1. 

0. 

1. 

0. 

1, 

0. 

1, 

0]. 

90. 

09. 





[0. 

1. 

0. 

1. 

0. 

1. 

0. 

1. 

0. 

1]. 

91. 

10. 





[1. 

0. 

1, 

0. 

1. 

0. 

1. 

0. 

1, 

0]. 

92. 

11. 





[0. 

1. 

0. 

1. 

0. 

1. 

0. 

1. 

0. 

1]. 

93. 

12. 





[1. 

0. 

1. 

0. 

1. 

0. 

1. 

0. 

1. 

0]. 

94. 

13. 





[0. 

1. 

0. 

1. 

0. 

1, 

0. 

1, 

0. 

1]. 

95. 

14. 





[1. 

0. 

1. 

0. 

1. 

0. 

1, 

0. 

1, 

0]. 

96. 

15. 





[0. 

1. 

0. 

1. 

0. 

1. 

0. 

1. 

0. 

1] 

97. 

16. 















98. 

17. 


"interval" : 

1 












99. 

18. 















100 

19. 

{ 














101 

20. 


"structure" : 

[ 

[0. 

0, 0, 0, 0, 1 

o 1 

1 

1 

1], 


102 

21. 





[1. 

1, 

1, 

1, 

1, 

0. 

0. 

0. 

0. 

0]. 

103 

22. 





[0. 

0. 

0. 

0. 

0. 

1. 

1. 

1. 

1. 

1]. 

104 

23. 





[1. 

1. 

1. 

1. 

1, 

0. 

0. 

0. 

0. 

0]. 

105 

24. 





[0. 

0. 

0. 

0. 

0. 

1. 

1, 

1, 

1, 

1]. 

106 

25. 





[1. 

1. 

1. 

1. 

1. 

0. 

0. 

0. 

0. 

0]. 

107 

26. 





[0. 

0. 

0. 

0. 

0. 

1. 

1. 

1. 

1. 

1]. 

108 

27. 





[1. 

1. 

1. 

1. 

1. 

0. 

0. 

0. 

0. 

0]. 

109 

28. 





[0. 

0. 

0. 

0. 

0. 

1, 

1, 

1, 

1. 

1]. 

110 

29. 





[1. 

1. 

1. 

1. 

1. 

0. 

0. 

0. 

0. 

0]. 

111 

30. 





[0. 

0. 

0. 

0. 

0. 

1. 

1. 

1. 

1. 

1]. 

112 

31. 





[1. 

1, 

1, 

1, 

1. 

0. 

0. 

0. 

0. 

0] 


32. 
















33. 


"interval" : 

.3 













34. 
















35. 

{ 















36. 


"structure" : 

[ 

[0. 

1, 0, 1, 0, 1, 0, ] 

L, 0, : 

L]. 


01. 

37. 





[1. 

0. 

1. 

0. 

1. 

0. 

1. 

0. 

1. 

0]. 

02. 

38. 





[0. 

1. 

0. 

1. 

0. 

1, 

0. 

1, 

0. 

1]. 

03. 

39. 





[1. 

0. 

1. 

0. 

1. 

0. 

1. 

0. 

1. 

0]. 

04. 

40. 





[0. 

1. 

0. 

1. 

0. 

1. 

0. 

1. 

0. 

1]. 

05. 

41. 





[1. 

0. 

1. 

0. 

1. 

0. 

1. 

0. 

1. 

0]. 

06. 

42. 





[0. 

1, 

0. 

1, 

0. 

1. 

0. 

1. 

0. 

1]. 

07. 

43. 





[1. 

0. 

1, 

0. 

1, 

0. 

1. 

0. 

1. 

0]. 

08. 

44. 





[0. 

1. 

0. 

1. 

0. 

1. 

0. 

1. 

0. 

1]. 

09. 

45. 





[1. 

0. 

1. 

0. 

1, 

0. 

1, 

0. 

1. 

0]. 

10. 

46. 





[0. 

1. 

0. 

1. 

0. 

1. 

0. 

1. 

0. 

1]. 

11. 

47. 





[1. 

0. 

1, 

0. 

1. 

0. 

1. 

0. 

1, 

0]. 

12. 

48. 





[0. 

1, 

0. 

1, 

0. 

1. 

0. 

1. 

0. 

1] 

13. 

49. 















14. 

50. 


"interval" : 

.2 












15. 

51. 















16. 

52. 

{ 














17. 

53. 


"structure" : 

[ 

[1. 

0, 0, 0, 0, 0, 0, 0, 0, 0], 


18. 

54. 





[0. 

1. 

0. 

0. 

0. 

0. 

0. 

0. 

0. 

0]. 

19. 

55. 





[0. 

0. 

1. 

0. 

0. 

0. 

0. 

0. 

0. 

0]. 

20. 

56. 





[0. 

0. 

0. 

1. 

0. 

0. 

0. 

0. 

0. 

0]. 

21. 

57. 





[0. 

0. 

0. 

0. 

1. 

0. 

0. 

0. 

0. 

0]. 

22. 

58. 





[0. 

0. 

0. 

0. 

0. 

1. 

0. 

0. 

0. 

0]. 

23. 

59. 





[0. 

0. 

0. 

0. 

0. 

0. 

1. 

0. 

0. 

0]. 

24. 

60. 





[0. 

0. 

0. 

0. 

0. 

0. 

0. 

1, 

0. 

0]. 

25. 

61. 





[0. 

0. 

0. 

0. 

0. 

0. 

0. 

0. 

1. 

0]. 


62. 





[0. 

0. 

0. 

0. 

0. 

0. 

0. 

0. 

0. 

1]. 


63. 





[0. 

0. 

0. 

0. 

0. 

0. 

0. 

0. 

1. 

0]. 

27. 

64. 





[0. 

0. 

0. 

0. 

0. 

0. 

0. 

1, 

0. 

0]. 

28. 

65. 





[0. 

0. 

0. 

0. 

0. 

0. 

1. 

0. 

0. 

0]. 

29. 

66. 





[0. 

0. 

0. 

0. 

0. 

1, 

0. 

0. 

0. 

0]. 

30. 

67. 





[0. 

0. 

0. 

0. 

1, 

0. 

0. 

0. 

0. 

0]. 


68. 





[0. 

0. 

0. 

1. 

0. 

0. 

0. 

0. 

0. 

0]. 

31. 

69. 





[0. 

0. 

1. 

0. 

0. 

0. 

0. 

0. 

0. 

0]. 

32. 

70. 





[0. 

1. 

0. 

0. 

0. 

0. 

0. 

0. 

0. 

0]. 

33. 

71. 





[1. 

0. 

0. 

0. 

0. 

0. 

0. 

0. 

0. 

0]. 

34. 

72. 





[0. 

1. 

0. 

0. 

0. 

0. 

0. 

0. 

0. 

0]. 

35. 

73. 





[0. 

0. 

1. 

0. 

0. 

0. 

0. 

0. 

0. 

0]. 

36. 

74. 





[0. 

0. 

0. 

1. 

0. 

0. 

0. 

0. 

0. 

0]. 

37. 

75. 





[0. 

0. 

0. 

0. 

1. 

0. 

0. 

0. 

0. 

0]. 


76. 





[0. 

0. 

0. 

0. 

0. 

1. 

0. 

0. 

0. 

0]. 


77. 





[0. 

0. 

0. 

0. 

0. 

0. 

1. 

0. 

0. 

0]. 

38. 

78. 





[0. 

0. 

0. 

0. 

0. 

0. 

0. 

1. 

0. 

0]. 

39. 


[0, 0, 0, 0, 0, 0, 0, 0, 

[0, 0, 0, 0, 0, 0, 0, 0, 

[0j 0j 0j 0j 0j 0j 0j 0j 

[0, 0, 0, 0, 0, 0, 0, 1, 

[0j dj dj Qj Qj Qj Ij dj 

[0, 0, 0, 0, 0, 1, 0, 0, 

[0j 0j 0j 0, Ij dj Qj Qj 

[0, 0, 0, 1, 0, 0, 0, 0, 

[0, 0, 1, 0, 0, 0, 0, 0, 

[0j Ij dj Qj Qj Qj Qj Qj 

[1, 0, 0, 0, 0, 0, 0, 0, 

[0j Ij 0j 0j 0j Qj Qj Qj 

[0, 0, 1, 0, 0, 0, 0, 0, 

[0, 0, 0, 1, 0, 0, 0, 0, 

[0j dj Qj Qj Ij Qj Qj dj 

[0, 0, 0, 0, 0, 1, 0, 0, 

[0j 0j 0j 0j 0j 0j Ij 0j 

[0, 0, 0, 0, 0, 0, 0, 1, 

[0j 0j 0j 0j 0j 0j 0j 0j 

[0j 0j 0j 0j 0j 0j 0j 0j 

[0, 0, 0, 0, 0, 0, 0, 0, 

[dj Qj dj dj 0j 0j 0j Ij 

[0, 0, 0, 0, 0, 0, 1, 0, 

[0j 0j 0j 0j 0j Ij 0j 0j 

[0, 0, 0, 0, 1, 0, 0, 0, 

[0j 0j 0j Ij 0j 0j 0j 0j 

[0, 0j Ij 0j 0j 0j 0j 0j 

[0, 1, 0, 0, 0, 0, 0, 0, 

[Ij 0j 0j 0j 0j 0j 0j 0j 

]. 

"interval" : 0.5 

} 

] 


AlupA.py 

import projectiles j random 

class Player(): 

X = 0 
y = 0 

firing = False 
image = None 
shieldimage = None 
drawShield = False 

soundEffect = 'sounds/player_laser.wav' 

pygame = None 

surface = None 

width = 0 

height = 0 

bullets = [] 

bulletimage = "assets/you_pellet.png" 

bulletSpeed = -10 

health = 5 

maxHealth = health 

shields = 3 

maxShields = shields 


1 . 0 ]. 
0 . 1 ]. 

1, 0], 
0 , 0 ], 
0 , 0 ], 
0 , 0 ]. 
0 , 0 ], 
0 , 0 ], 
0 , 0 ], 
0 , 0 ], 
0 , 0 ]. 
0, 0], 
0 , 0 ]. 
0 , 0 ], 
0 , 0 ], 
0 , 0 ]. 
0 , 0 ], 
0 , 0 ]. 
1 , 0 ], 
0 , 1 ], 
1 , 0 ], 
0 , 0 ], 
0 , 0 ], 
0 , 0 ], 
0 , 0 ]. 
0 , 0 ], 
0 , 0 ], 
0 , 0 ], 
0 , 0 ] 


def loadlmages(self) : 

self-image = self .pygame. image. load("assets/you_ship. png") 
self .shieldimage = self .pygame. image. load 
( "assets/shield2. png" ) 

def draw(self ) : 

self .surface. blit(self. image, (self.x, self.y)) 
if self .drawShield == True: 
self . surface. blit(self. shieldimage, (self.x - 3, 
self.y - 2)) 

self .drawShield = False 

def setPosition(self, pos): 
self.x = pos[0] - self. width / 2 

def fire(self): 

self .bullets. append(projectiles.Bullet(self.x + self. width 
/ 2, self.y, self. pygame, self .surface, self .bulletSpeed, self, 
bulletimage)) 

a = self .pygame. mixer. Sound(self. soundEffect) 
a . set_volume(0 .2) 
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Tutorial 


WALKTHROUGH 


41. a. play 0 


43. def drawBullets(self) : 

44. for b in self .bullets: 


45. b.moveO 

46. b.drawO 

47. 

48. def registerHit(self) : 

49. if self. shields == 0: 

50. self. health -= 1 

51. else : 

52. self. shields -= 1 

53. self .drawShield = True 

54. 

55. def checkForHit(selfj thingToCheckAgainst) : 

56. bulletsToRemove = [] 

57. 

58. for idXj b in enumerate( self .bullets) : 

59. if b.x > thingToCheckAgainst.x and b.x < 

thingToCheckAgainst.x + thingToCheckAgainst. width: 

60. if b.y > thingToCheckAgainst.y and b.y < 
thingToCheckAgainst.y + thingToCheckAgainst. height: 

61 . thingToCheckAgainst . registerHit ( ) 

62. bulletsToRemove. append (idx) 

63. bC = 0 

64. for usedBullet in bulletsToRemove: 

65. del self .bullets [usedBullet - bC] 

66. bC += 1 

67. 

68. if thingToCheckAgainst. health <= 0: 

69. return True 

70. 

71. def init (selfj x^ y^ pygame^ surface): 

72. self.x = X 

73. self.y = y 

74. self.pygame = pygame 

75. self. surface = surface 

76. self .loadImagesO 

77. 

78. dimensions = self .image.get_rect() .size 

79. self. width = dimensions [0] 

80. self. height = dimensions[l] 

81. 

82. self.x -= self. width / 2 

83. self.y -= self. height + 10 

84. 

85. class E nemy( Player ) : 

86 . 


01 . 

02 . 

03. 

04. 

05. 

06. 

07. 

08. 

09. 

10 . 


12 . 

13. 

14. 

15. 

16. 

17. 

18. 

19. 

20 . 
21 . 
22 . 

23. 

24. 

25. 

26. 

27. 

28. 


30. 

31. 

32. 

33. 

34. 

35. 

36. 

37. 

38. 

39. 

40. 

41. 

42. 


87. 

88 . 

89. 

90. 

91. 

92. 

93. 


95. 

96. 

97. 

98. 

99. 

100 . 
101 . 
102 . 

103. 

104. 

105. 

106. 

107. 

108. 

109. 

110 . 
111 . 
112 . 

113. 

114. 

115. 

116. 

117. 

118. 

119. 

120 . 
121 . 
122 . 


X = 0 
y = 0 

firing = False 
image = None 

sound Effect = 'sounds/enemy_laser.wav' 
bulletimage = "assets/them_pellet.png" 
bulletSpeed = 10 
speed = 2 
shields = 0 

def move (self): 

self.y += self. speed 

def tryToFire(self) : 

shouldFire = random. random() 

if shouldFire <= 0.01: 
self .fire() 


43. 


45. 

46. 

47. 

48. 

49. 

50. 

51. 

52. 

53. 

54. 

55. 


56. 

57. 


58. 

59. 


def loadlmages(self) : 

self. image = self .pygame. image. load ("assets/them_ship. png") 


def init (selfj x, y^ pygame^ surface^ health): 

self.x = X 
self.y = y 

self.pygame = pygame 
self. surface = surface 
self .loadImagesO 
self. bullets = [] 


self. health = health 69. 

70. 

dimensions = self .image.get_rect() .size 71. 

self .width = dimensions [0] 72. 

self. height = dimensions[l] 73. 

74. 

self.x += self. width / 2 75. 


alieiu^ 

import pygame j sys, random^ math 
import pygame. locals as GAME_GLOBALS 
import pygame. event as GAME_EVENTS 
import pygame. time as GAME_TIME 
import ships 

import gameLevels 

windowWidth = 1024 
windowHeight = 614 
timeTick = 0 

pygame. init 0 
pygame . font . init ( ) 

surface = pygame.display.set_mode((windowWidthj windowHeight) ^ 
pygame. FULLSCREEN) 

pygame.display.set_caption( 'Alien\'s Are Gonna Kill Me!') 
textFont = pygame. font .SysFont( "monospace" ^ 50) 

gameStarted = False 
gameStartedTime = 0 
gameFinishedTime = 0 
gameOver = False 
gameWon = False 

currentLevel = 0 
currentWave = 0 
lastSpawn = 0 
nextLevelTS = 0 

# Mouse variables 
mousePosition = (0^0) 
mouseStates = None 
mouseDown = False 

# Image variables 

startScreen = pygame. image. load ("assets/start_screen. png") 
background = pygame. image. load ("assets/background. png") 
loseScreen = pygame. image. load ("assets/lose_screen. png") 
winScreen = pygame. image. load ("assets/win_screen. png") 
nextWave = pygame. image. load ("assets/next_level. png") 
finalWave = pygame. image. load ("assets/final_level. png") 

# Ships 

ship = ships. Player (windowWidth / 2j windowHeight^ pygame^ surface) 
enemyShips = [] 

leftOverBullets = [] 

# Sound setup 
pygame . mixer . init ( ) 

def launchWaveO : 

global lastSpawnj currentWave^ currentLevel^ gameOver^ gameWon^ 
nextLevelTS 

thisLevel = gameLevels. level[currentLevel] ["structure"] 

if currentWave < len(thisLevel) : 

thisWave = thisLevel [currentWave] 

for idXj enemyAtThisPosition in enumerate(thisWave) : 
if enemyAtThisPosition is 1: 
enemyShips . append (ships . Enemy ( ( (windowWidth / 
len (thisWave)) * idx)^ -60^ pygame^ surface^ 1)) 

elif currentLevel + 1 < len (gameLevels. level) : 
currentLevel += 1 
currentWave = 0 

ship. shields = ship.maxShields 
nextLevelTS = timeTick + 5000 
else: 

gameWon = True 
lastSpawn = timeTick 
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76. currentWave += 1 155. 

77. 156. 

78. def updateGameO : 157. 

79. 158. 

80. global mouseDowrij gameOverj gameWorij leftOverBullets 159. 

81. 160. 

82. if mouseStates[0] is 1 and mouseDown is False: 161. 

83. ship.fireO 

84. mouseDown = True 

85. elif mouseStates[0] is 0 and mouseDown is True: 

86. mouseDown = False 162. 

87. 163. 

88. ship.setPosition(mousePosition) 164. 

89. 165. 

90. enemiesToRemove = [] 166. 

91. 167. 

92. for idXj enemy in enumerate(enemyShips) : 168. 

93. 169. 

94. if enemy. y < windowHeight : 170. 

95. enemy, move 0 171. 

96. enemy. tryToFireO 172. 

97. shipIsDestroyed = enemy. checkForHit(ship) 173. 

98. enemylsDestroyed = ship. checkForHit (enemy) 174. 

99. 175. 

100. if enemylsDestroyed is True: 176. 

101. enemiesToRemove. append (idx) 177. 

102. 178. 

103. if shipIsDestroyed is True: 179. 

104. gameOver = True 180. 

105. gameWon = False 181. 

106. return 182. 

107. 183. 

108. else: 184. 

109. enemiesToRemove. append (idx) 185. 

110. 186. 

111. oC = 0 187. 

112. 188. 

113. for idx in enemiesToRemove: 189. 

114. for remainingBullets in enemyShips[idx - oC]. bullets: 190. 

115. leftOverBullets. append (remainingBullets) 191. 

116. 192. 

117. del enemyShips[idx - oC] 193. 

118. oC += 1 194. 

119. 195. 

120. oC = 0 196. 

121. 

122. for idXj aBullet in enumerate ( leftOverBullets ) : 197. 

123. aBullet. move 0 198. 

124. hitShip = aBullet. checkForHit (ship) 199. 

125. 200. 

126. if hitShip is True or aBullet. y > windowHeight: 201. 

127. del leftOverBullets [idx - oC] 202. 

128. oC += 1 203. 

129. 204. 

130. def drawGameO : 205. 

131. 206. 

132. global leftOverBullets j nextLevelTSj timeTickj gameWon 207. 

133. 208. 

134. surface. blit(backgroundj (0, 0)) 209. 

135. ship.drawO 210. 

136. ship.drawBulletsO 211. 

137. 212. 

138. for aBullet in leftOverBullets: 213. 

139. aBullet. draw() 214. 

140. 215. 

141. healthColor = [(62, 180, 76), (180, 62, 62)] 216. 

142. whichColor = 0 217. 

143. 218. 

144. if (ship, health <= 1): 219. 

145. whichColor = 1 

146. 220. 

147. for enemy in enemyShips: 221. 

148. enemy. draw() 222. 

149. enemy. drawBulletsO 

150. 223. 

151. pygame.draw.rect( 224. 

surface, healthColor [whichColor], (0, windowHeight - 5, ( 225. 

windowWidth / ship.maxHealth) * ship. health, 5)) 226. 

152. pygame.draw.rect(surface, (62, 145, 180), (0, windowHeight 227. 

- 10, (windowWidth / ship.maxShields) * ship. shields, 5)) 228. 

153. 

154. if timeTick < nextLevelTS: 


if gameWon is True: 

surface. blit (finalWave, (250, 150)) 
else: 

surface. blit (nextWave, (250, 150)) 

def restartGameO : 

global gameOver, gameStart, 
currentLevel, currentWave, lastSpawn, 
nextLevelTS, leftOverBullets, gameWon, 
enemyShips, ship 

gameOver = False 
gameWon = False 
currentLevel = 0 
currentWave = 0 
lastSpawn = 0 
nextLevelTS = 0 
leftOverBullets = [] 
enemyShips = [] 
ship. health = ship.maxHealth 
ship. shields = ship.maxShields 
ship. bullets = [] 

def quitGame(): 
pygame.quitO 
sys.exitO 

# 'main' loop 
while True: 

timeTick = GAME_TIME.get_ticks() 
mousePosition = pygame. mouse. get_pos() 
mouseStates = pygame. mouse. get_pressed() 

if gameStarted is True and gameOver is False: 

updateGameO 

drawGameO 

elif gameStarted is False and gameOver is False: 
surface. blit(startScreen, (0, 0)) 

if mouseStates [0] is 1: 

if mousePosition [0] > 445 and mousePosition [0] < 580 and 
mousePosition [1] > 450 and mousePosition [1] < 510: 

gameStarted = True 

elif mouseStates [0] is 0 and mouseDown is True: 
mouseDown = False 

elif gameStarted is True and gameOver is True and gameWon is False: 
surface. blit(loseScreen, (0, 0)) 

timeLasted = (gameFinishedTime - gameStartedTime) / 1000 

if gameStarted is True and gameWon is True and len( enemyShips) is 0: 
surface. blit (winScreen, (0, 0)) 

# Handle user and system events 
for event in GAME_EVENTS.get() : 

if event. type == pygame . KEYDOWN : 

if event. key == pygame. K_ESCAPE: 
quitGameO 

if event. key == pygame. K_S PACE: 

if gameStarted is True and gameOver is True or 
gameStarted is True and gameWon is True: 
restartGameO 

if timeTick - lastSpawn > gameLevels. level [ current Level ] [ 

"interval"] * 1000 and gameStarted is True and gameOver is False: 
launchWaveO 

if event. type == GAME_GLOBALS.QUIT: 
quitGameO 

pygame . display . update( ) 


^langu^ 
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LEARN 


HIGH FLIERS 

British ESA astronaut Tim Peake won’t be the only Brit aboard the 
International Space Station next year. David Crookes looks at how 
the Pi got into the sky and what it means for future generations 


n 15 December, British ESA astronaut Tim 
Q Peake is set to make history as the first British 
astronaut to visit the International Space 
Station. For the next six months, he will achieve most 
children’s dreams as he lives and works 400 kilometres 
above the Earth to carry out a comprehensive science 
programme during a mission called Principia. 

His role will be to run experiments using the unique 
environment of space and to try new technologies that 
may become crucial when humans begin to visit other 
planets such as Mars. But he will not be alone. Aside 
from living with five international colleagues, all of 
whom have spent years training for their difficult 
roles, Tim will be greeted by another Brit - one set to 
accompany him throughout his time away from Earth. 

That extra ‘colleague’ will, of course, be the 
British-made Raspberry Pi which, by the time Tim 
sets off on a Soyuz spacecraft from Russia’s Baikonur 
cosmodrome in Kazakhstan, will already be waiting 
on board the ISS. Two Raspberry Pis will be flown 


skywards on a Cygnus cargo freighter on 3 December, 
going ahead of Tim thanks to a lack of room on the 
Soyuz flight. But it means the computers will be ready 
to be unboxed by the time Tim arrives. And then the 
fun and games can begin. 

The Raspberry Pi’s space adventure is referred to 
as the Astro Pi mission and, while it hasn’t been an 
easy ride for those involved, it is certainly set to be 
rewarding. That’s because the computers have been 
equipped with an expansion sensor board called the 
Sense HAT, and have been placed inside a cutting-edge 
aerospace case that has been built to withstand any 
conditions space will throw at it. As well as allowing the 
Raspberry Pi to measure the ISS’s environment, follow 
its journey through space, and pick up the Earth’s 
magnetic field, it will give schoolchildren the chance to 
have their code run in space for the first time ever. And 
that, says Tim, is proving to be most exciting of all. 

“[Astro Pi] has got a great sensor suite with 
temperature, pressure, humidity sensors, all sorts of 
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things on it/’ he told BBC television’s The One Show 
following the final press conference on 6 November. 
“So, the schoolkids basically coded programs that I’m 
going to run on board the Space Station, and this Astro 
Pi is going to be in various different modules running 
an experiment each week. I’m going to send down the 
data so that during the mission they can see [it], see 
what they’ve managed to achieve, and if they need to 
modify the code, they can send it back up to me.” 

The Astro Pi was the brainchild of the UK Space 
Agency and the Raspberry Pi Foundation, although 
it was, according to David Honess, the Foundation’s 
education resource engineer, “a case of being in 
the right place at the right time”. Libby Jackson, 
the UK Space Agency’s astronaut flight education 
programme manager, was looking at ways to 
encourage children to think about the applications 
for space and the ISS. “When I was applying for my 
current role, the candidates were asked to prepare 
an idea for an activity that could inspire kids and at 
the time I knew about the Raspberry Pi,” she says. “I 
didn’t take that idea to the interview because I didn’t 
know enough and I was afraid I’d be asked questions 
I couldn’t answer.” 

The idea remained with her and when she was 
talking with UK Space, the UK space industry’s trade 
association, she confessed she couldn’t shake away 

ASTRO PI UP CLOSE 


the idea of having fun with the Raspberry Pi. “As it 
happened, someone mentioned that they had been 
talking to Eben Upton, the CEO of the Raspberry Pi 
Trading company, and so had a point of contact. A 
meeting was quickly set up,” she says. 

The momentum began building solidly. At this time, 

David had just begun working with the Raspberry Pi 
Foundation and Eben had sent a casual email asking 

A case of being in the right 
place at the right time 

if anyone fancied accompanying him to a meeting 
with Airbus Defence and Space. David volunteered 
and found that Dr Stuart Eves, Airbus’s lead mission 
concepts engineer, was a passionate advocate of the 
Raspberry Pi. This resulted in the Pi Foundation being 
hooked up with Libby at the UK Space Agency: “We 
ended up in a meeting with the UK Space Agency and 
Tim Peake’s mission was on the table...” 

A decision was soon taken to exploit the 
possibilities of that mission as much as possible, 
and so the idea of a competition to engage schools 
was seized upon. The belief was that it could 


01 The most noticeable part of 
the Astro Pi assembly is the 8 x 8 
RGB LED matrix on the Sense 
HAT. It has a Gofps refresh rate 
and 15 -bit colour resolution. 

02 The all-in-one gyroscope, 
accelerometer, and 
magnetometer will measure the 
orientation of objects, an increase 
in speed, and the strength and 
direction of a magnetic field. 

03 A temperature and humidity 
sensor not only measures hot and 
cold, but the amount of water 
vapour in the air. It can detect 
whether a person is standing 
close by, for instance. 

04 The barometric pressure 
sensor is able to measure the 
force exerted by small molecules 
in the air. 

05 The graphics are 

driven by this microcontroller. 


06 To allow the astronauts 
to navigate the screen and 
options, there is a five- 
button Joystick which allows 
for up, down, left, and right 
movements, as well as 

an Enter via a click. 

07 This hole allows air to enter 
the Astro Pi device, where 

it can be detected by the 
sensors and tested. 

08 The actual casing is made 
from aerospace-grade aluminium 
and it is said to have cost £ 3,000 
to make. 

09 As well as the various 
special components of the 
Sense HAT, the usual functions 
of the Raspberry Pi are used. 

This is the power socket. 

10 Here we see the various 
connections of the Raspberry Pi, 
from USB sockets to LAN. 
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encourage schoolchildren to become more interested 
in space and open their eyes to its employment 
possibilities. ‘‘The bottom line is that the UK space 
industry wants to ensure that there are enough people 
in the future to hire to carry on doing what they are 


together around a year before the expected flight, 
so there was never going to be enough time to 
invite children to come up with an experiment and 
make it fly. “We turned things on their head and 
said if we fly the hardware as it exists and ask the 
kids what we should do with it, that would help 
in terms of time,’’ Libby continues. “It seemed 
the perfect solution.” 

Pi in the sky 

It is not the first time a hare-bones computer has gone 
into space (and it’s not incidentally the Pi’s debut 
either, given Dave Akerman’s efforts in strapping Pis 
to high-altitude balloons and taking snapshots from 
the edge of space). But while Arduinos were the first to 
boldly go where no other widely accessible device had 
gone before (on to satellites orbiting the Earth), Astro 
Pi was created to be different. 

“Never before have we had a situation where the 
crew of the space station are using the same machine 
as your kids,” says David. “But this is that time: we 
created the Sense HAT add-on board for the Pi and 


The bottom line is that the UK space industry 
wants to ensure that there are enough people in the 
future to hire to cany on doing what they are doing 



doing,” explains David. “And we feel this is part of 
the answer.” 

Once the go-ahead had been given, it was time 
to work out how the project would run. For Libby, 
the aim was to attach as much as possible to the Pi 

- “I knew the history of getting education payloads 
on the ISS,” she explains, hinting at the difficulties 

- but the problem was the tight schedule they had 
to work with. The Astro Pi mission was being put 


we challenged schools to come up with computer 
science-based experiments that Tim would run 
on the space station.” 

The response from schoolchildren amazed everyone, 
not only in the quantity of entries but in their quality. 
There were stories of children coding during their 
lunch breaks and working after school. The chance 
of having their code in space was proving to be a great 
motivator, and narrowing the experiments down to 


LIFE ON THE ISS 

The Astro Pi is going to live on board the 

WAKE-UP 

WORKING DAY 

International Space Station until 2022, 

Like everyone else on board, Tim 

Tim’s days will closely 

when it is envisaged the battery operating 

will adhere to the GMT time zone. 

follow our own working 

its real-time clock will finally run out of 

He will wake each morning in a 

lives. He is set to 

power. During those seven years, the 

small soundproofed cabin, have his 

spend his time with 

Pi will be made available for use by 

breakfast, and get down to work. "They 

five other astronauts 

numerous crews, starting with Tim Peake, 

commute by floating in, and they 

in an environment that 

whose mission is set to cross between 

start with a meeting with the ground 

is equivalent to a five- 

Expedition 46 and 47 (the current crew 

controller to catch up on the day," says 

bedroom house, and 

are part of Expedition 44). But just what 

Libby Jackson, the UK Space Agency’s 

he will typically work a 

is life like on board the ISS, and how 

astronaut flight education programme 

Monday to Friday week. 

much time will Tim get to spend with 

manager. "Then they will carry on and 

starting at Sam and 

the computer? 

do their science experiments." 

finishing at 6pm. 
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just seven winners proved tricky. ‘‘It came down to 
the completeness of the ideas and the quality of the 
coding/’ reveals Libby. “The things the kids came up 
with are far more creative than adults.” 

Indeed, the winners are certainly impressive. The 
Cranmere Code Club run by teacher (and The MagPi 
writer) Richard Hayler at the Cranmere Primary School 
tests the humidity surrounding Astro Pi. If fluctuation 
is detected, it is a possible indicator that an astronaut 
has come close, so the Pi will deliver a message on 
its 8x8 LED screen and take a photo via the camera, 
hoping to snap one of the ISS crew in action. “They 
are looking to see if humidity is a good indictor of the 
presence of the crew near the Astro Pi,” David explains. 

SpaceCRAFT is equally ingenious, with Hannah 
Belshaw from the Cumnor House Girls School 
suggesting using the output as a CSV file from the Astro 


Pi sensors within Mmecraft so that the environmental Above Tim 
measurements are represented m the game. jn theSoyuzTMA 

“SpaceCRAFT logs all sensors to fill a massive CSV simulator 

file and it works with code on the ground that plays 
it back in Minecra/t,” says David. Hannah dressed 
in a spacesuit to appear alongside Tim during 
his BBC interview. 

One particular favourite among those involved 
with Astro Pi is Flags, created by Thirsk School under 
the watch of teacher Dan Aldred. The program uses 
telemetry data and the Astro Pi’s real-time clock to 
work out the ISS’s location. It searches its database 
to find the relevant flag and displays it on the screen 
with a phrase in the local language. 

“It’s lovely because the children have looked and 
thought about where the astronauts are in the world,” 
says Libby. David agrees. “The crew will like it,” he 


KEEPING FIT 

Each day is carefully 
scheduled so that the 
astronauts’ time on board 
is fully utilised, and that 
includes hours set aside for 
maintenance. But they must 
also have time for exercise. 
Without regular fitness 
sessions, they can suffer bone 
and muscle loss. "They have 
two hours of exercise each 
day," reveals Libby. 


CHIT CHAT 

It is also important that the 
astronauts get some time to 
socialise. It can, after all, be 
lonely in space. "They try to get 
an hour lunch break together, 
just like we would on Earth," says 
Libby, explaining that mealtimes 
balance vitamins and minerals. 
"Some days they manage it, 
other days they work through 
or they stagger it, but [eating 
together] is the aim." 




GOODNIGHT 

At the end of the day, 
they seek to wrap things 
up. "They have a meeting 
with the crew and say 
goodnight," says Libby. 
"They can enjoy free 
time and during the 
evening and weekends, 
the mission controllers 
try not to disturb the 
crew unless they really 
have to." 


TIME FOR PI 

But what do they get up to? 
"Some will watch movies, 
others will look out of the 
window or call friends and 
family," says Libby. "On 
Saturday morning they will 
clean the space station, but 
Tim will hope to spend the 
afternoon doing education, 
working with the Astro 
Pi. Sunday will be his day 
ofF, though." 
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SEE THE ISS WITH YOUR PI 


says. ^‘The kids learned a lot about geography and they 
made the code recognise the boundaries of different 
countries. If it’s above the sea, it shows a twinkly blue 
or green pattern.” 

Watchdog, by Kieran Wand at Cottenham Village 
College, makes good use of the Astro Pi sensors by 
measuring the temperature, pressure, and humidity 
on board the ISS, raising the alarm if they move 
outside acceptable parameters. Trees, by EnviroPi 
- a team at Westminster School - points the NoIR 
camera on the Astro Pi out of the window and allows 
it to take images of the ground, after which it can 
produce a Normalised Differentiated Vegetation Index 
(a measure of plant health). 

Radiation, by the team Arthur, Alexander, and 



One of the great things about the ISS is that you c 
able to see it with your own eyes and without the 
aid of a telescope. The trick is knowing where it is 
in the sky at any given time, but there are apps and 
websites which allow you to follow it as it orbits 
400 kilometres above Earth. 

The Principia Mission website has an ISS 
spotter, which you can view by going to 
principia.org.uk/iss-sightings. There is also a 
Pi-based project called ISS Above, which can be 
hooked up to a TV to display the location of the 
ISS in real-time. 

It began as a Kickstarter project and raised 
$17,731 from 199 backers, having originally asked 
for $5,000. Maker Liam Kennedy wanted to 
produce something which lit up whenever the 
ISS was nearby. 


Kiran, overseen by Dr Jesse Peterson at Magdalen 
College School, uses the Camera Module of the Pi 
to detect radiation, measuring the intensity of tiny 
specks of light. But there is always time for fun, 
and so Lincoln UTC’s Team Terminal, with teacher 
Mark Hall, have produced a suite of reaction games, 
together with a menu that the astronauts can use to 
select the one they fancy playing at that time. 

Tim's role 

Tim will be able to move between these experiments 
via an app on board the Astro Pi, called the Master 
Control Program (a nod to the 1982 movie Iron). But 
he doesn’t have to keep checking it. The programs 
can run automatically. ‘‘There is a clock icon which 
will run program X for a set period,” David explains. 
“It ensures the programs are run for the right 
amount of time.” 
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Indeed, schedules have been specified, defining how 
many seconds each experiment should run for. ‘‘He can 
use the joystick to go down to the different programs and 
if he wants to run one, then he can press the ‘right’ button 
which shows an arrow on the screen and then starts that 
program,” says David. “The results are written to the SD 
card and they go into a folder called Transfer, which Tim 
can copy and send down to us.” 

Tim will be conducting experiments of his own away 
from the Pi. One will involve studying metals using the 
on-board electromagnetic levitator, a furnace which 
heats the metals to 2,ioo°C and rapidly cools them in a 
gravityless environment. The removal of gravity allows for 
a more accurate observation of fundamental properties of 
different metals, alloys, and the rates of cooling. 

He will also be looking at organisms placed on the 
exterior of the ISS to see how a lack of oxygen, extreme 
temperature changes, and radiation affects them. Perhaps 
most importantly, Tim will study the measurement of 
brain pressure in space. There has long been a worry that 
space exploration (and time on the ISS) can affect the 
vision of astronauts. As low gravity allows blood to rise, it 
increases brain pressure and pushing on the back of the 
eyes. Tim will help researchers at the University Hospital 
Southampton NHS Foundation Trust better understand 
the open fluid links between the brain and the ear that 
could form a better way of testing astronaut health. 

But where does that leave the education part of his 
mission? “In the official world, Tim will have four hours 
of education activity time per expedition,” say Libby. With 
Tim working within Expedition 46 and 47, that equates to 
eight hours. It doesn’t sound a lot and Libby admits it isn’t 
- “in space everything floats, so we usually say work out 
how long it will take to do something on Earth and triple 
the time” - but Tim is brilliantly committed to ensuring 
the mission is fun for the next generation of children. 

To that end, he wants them to get the most out of it 
and share the mission. “He will spend a lot of Saturday 
afternoons working on education projects,” says Libby. 



“Astro Pi is one of our flagship education programmes Above Tim tries 
and we’re looking forward to it. Education is going to be ^ spacesuit 

very important in Tim’s mission.” 

As such, this could well be a turning point for the space 
industry in the UK. “Only a small number of people can 


II 


Only a small number of 
people can be an astronaut 


II 


be an astronaut, and that is what kids think about,” says 
David. “They also see space as abstract and only associate 
it with NASA. But we are showing the various roles and 
the possibilities. We’re calling it the Tim Peake effect and 
we hope that in five to ten years’ time we have a booming 
space industry [similar to the Apollo effect in the USA in 
the 1960s and 1970s, which boosted interest in science and 
engineering]. It’s a bold aim, but it’s everybody’s hope.” 


ON THE CASE 


Did you know that the casing for the 
Astro Pi is possibly the Raspberry Pi 
Foundation’s biggest achievement 
(aside from making the Pi itself, 
that is)? Large and chunky, it has 
had to adhere to the regulations 
stipulated by the European Space 
Agency, and that means it must be 
as safe as a child’s toy. 

All of the edges were inspected 
to ensure they were not sharp, so 
testers ran their gloved hands over 
the casing many times to check for 
potential drag. The heat generated 


by the Pi must also be conducted 
away via thermal radiation, so the 
casing has lots of pins, each of 
which can remove 0.1 watt of heat. 

The Pi itself is in contact with the 
case, which aids heat removal, and 
tests show that it will not get hotter 
than 32°C - 13°C below the cutoff 
point. "There was no aesthetic 
consideration in designing 
the case,’’ says David Honess, 
the Raspberry Pi Foundation’s 
education resource engineer, 

"but it does look awesome.’’ 
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> Sense HAT 
magpi.cc/ 
SenseHAT 

> Sense HAT 
Python Library 
magpi.cc/ 
iRKRoqc 
(pre-instaLLed on 
Raspbian Jessie) 


LED MATRIX 

The Sense HAT, a fundamental part of the Astro Pi Mission, allows your 
Raspberry Pi to sense the world around you. Here’s how to get started... 


he Sense HAT is an add-on board for the 

^ Raspberry Pi, made especially for the Astro 
Pi competition. The board adds the ability 
to sense all kinds of things and output information 
using a built-in 8x8 LED matrix. You can find out 
more about what the Sense HAT can do by following 
the Astro Pi Guide (magpi.cc/AstroPiGuide), which 
will show you how to connect and test your Sense HAT. 
It also has some helpful explanations and examples of 
what the different inputs and outputs can do. 

In order to write your programs, though, youTl need 
to boot your Raspberry Pi to the desktop and start 
IDLE3, the Python 3 editor, by entering the following 
command into a Terminal window: 

sudo idles & 

For our first trick, weTl display text on the HAT’s 
LED matrix. This program contains two crucial lines of 
code, which import the Sense HAT software and create 
a sense object which represents the Sense HAT: 

.from sense_hat import SenseHat 

sense SenseHat() 


The next line makes the Sense HAT actually 
do something: 

sense. show_message( 

"I want to be an astronaut!") 

You've probably already discovered that you 
can easily change the message to your own text, 
but there’s much more you can do. For example, we 
can expand the sense . show_message command 
to include some extra parameters which will change 
the behaviour of the message - see Fig 1 on the facing 
page for details. 

The following program will display the text 
‘Astro Pi is awesome!’ more slowly, with the text 
in yellow [255,255,0] and the background in 
blue [0,0,255]: 

sense_hat SenseHat 

sense SenseHat() 

sense. show_message( "Astro Pi is awesome!", 
scroll_speed: 0.05, text_colour= [255,255,0], 
back_colour: [0,0,255]) 
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You could also make the message repeat by using 
awhile loop: 

sense_hat SenseHat 

sense SenseHat() 

True: 

sense. show_message( 

"Astro Pi is awesome!!", scroll_ 
speed: 0.05, text_colour 
[255,255,0], back_colour [0,0,255]) 


Now weVe made our first program, we should save 
it. Click File > Save As, give your program a name like 
loop_text.py, then press F5 to run it. Easy! 

The LED matrix can also display a single character 
rather than an entire message, using the 

I sense . show_letter function, which has the same 
optional parameters (see Fig 1). 

Displaying images 


Of course, the LED matrix can display more than just 
text. We can control each LED individually to create 
our own images, and there are a couple of different 
ways we can accomplish this. The first approach is to 
set pixels (LEDs) individually; we can do this using 
the sense . set_pixel ( ) command. First, we need to 
be clear about how we describe each pixel. 

The Sense HAT uses a coordinate system; the 
numbering begins at 0, not 1. The origin is in the top- 
left rather than the bottom-left, as you may be used 
to. Try the following program (and see Fig 2): 


from' sense_hat import SenseHat 
sense SenseHat() 
sense. set_pixel(0, 2, [0, 0, 255]) 
sense. set_pixel(7, 4, [255, 0, 0]) 


Setting pixels individually works, but it gets rather 
complex when you want to set lots of pixels. There is 
another option, though: sense. set_pixels. 

Its use is quite straightforward; we just give a list of 
colour values for each pixel. We could enter: 

sense. set_pixels([ [255, 0, 0], 

[255, 0, 0], [255, 0, 0], [255, 0, 0],...]) 

...but this would take ages. Instead, you can use 
some variables to define your colour palette - in this 
example wehe using the colours of the rainbow: 

r [255, 0, 0] 

0 [255, 127, 0] 

y [255, 255, 0] 

g [0, 255, 0] 

b [0, 0, 255] 

1 [75, 0, 130] 

V [159, 0, 255] 




scroU.speed 

The scrolLspeed parameter affects how quickly the 

text moves on the screen. The default value is 0.1. 

The bigger the number, the slower the speed. 



back_colour 

The back_colour parameter alters the colour of the 
background and is specified as three values for red. 
green, and blue. Each value can be between 0 and 

255. so [255.255.0] would be red + green = yellow. 


e [0, 0, 0] # e is for empty 

We can then describe our matrix by creating a 2D 
list of colour names: 


Fig 1 ; Available 
parameters 
for the 

show.message 

command 


image [ e,e,e,e,e,e,e,e. 


e,e,e,r,r,e,e,e. 


e,r,r,o,o,r,r,e, 
r',o,o,y,y,o,o,r, 
o,y,y,g,g,y,y,o, 
y,g,g,b,b,g,g,y, 
b,b,b,i,i,b,b,b, 
b,i,i,v,v,i,i,b ] 

Once you have the colour and image variables, you 
can then simply call them by adding: 
sense. set_pixels(image) 

...but don’t forget to start your listing with: 

sense_hat SenseHat 

sense SenseHat() 


Click File > Save As, give your program a name 
e.g. rainbow.py, then press F5 to run. What will you 
display on your Sense HAT? 
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> Raspbian 

magpi.cc/ 

iMYYTMo 


> Scratch 
(pre-instaLLed 
on Raspbian) 



GRAVITY 




SIMULATOR 


The Sense HAT, a fundamental part of the Astro Pi mission, allows your 
Raspberry Pi to sense the world around you. Here’s how to get started... 


I 


n space, it feels like everything is floating. 

This is because everything becomes weightless 
outside of our planet, Earth. This is probably 
the biggest difference from being on Earth, where 
everything is pulled down towards the ground. On Earth 
we can all feel this downward pull, but we are so used to 
it that we sometimes don't even think about it. This pull 
or attraction we feel is called gravity. 

You can recreate the effects of the force of gravity on 
Earth in this Scratch simulation! 

Open Scratch by clicking on Menu and Programming, 
followed by Scratch. Alternatively, you can use Scratch 
2.0 online for this activity, although some of the blocks 
may be slightly different. Once opened, create a new file 
by selecting File and New. 

Next, delete the Scratch cat sprite by right-clicking on 
it and selecting Delete from the menu that is displayed. 
For this project, you need to create a new background to 
act as the Earth. To do this, click on Stage in the sprites 
palette (bottom-right) and then click on Backgrounds 
next to the Scripts tab. Click on Paint to draw your own 
background, then select the rectangle icon and a green 
colour. It’s important that you fill the rectangle with one 
solid colour. Draw a green rectangle at the bottom of the 
image to represent the Earth. Once you’re happy with 
your stage design, click OK. 


You’ll need to choose a sprite to use as your character. 
You can use the Scratch cat sprite, or you can use our 
Mooncake - the Astro Cat sprite. You can find Mooncake 
here: magpi.cc/iPEbjIm. Once you’ve got it, add it as a 
new sprite by clicking on the middle icon on the sprites 
palette, selecting Astro-cat.png from the choices and 
clicking OK. 

In order for your gravity simulator to work with 
this sprite, you’ll need to set the costume center of 
Mooncake the Astro Cat by selecting the sprite, then 
clicking on Costumes followed by Edit. In the Paint 
Editor window, you’ll see a button with a ‘+’ symbol on 
it. When clicked, it will show a crosshair over the sprite, 
which you’ll be able to move with your mouse. Move it 
so that it selects the tummy of Mooncake and when you 
are happy, click OK. 

Click on the Scripts tab of the sprite and save your 
Scratch project work by clicking on File and Save As. 
Name your program Gravity simulation and save it in 
your home directory or some place that you can find 
it later. 


storing data 


To create a variable, click on Variables in the blocks 
palette (top-left) and then click Make a Variable. 

The New Variable window opens and asks you to type 
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a name for your variable. Name the first variable 
gravity and ensure that For all sprites is checked 
before clicking OK. A variable holds a value that can be 
changed, and can be used elsewhere in your program. 

Youhl see some orange blocks are added to your 
Variables area, called gravity, and a small counter 
box will appear on the stage. Youhl also need to make 
another variable in the same way as you Ve just done, 
called velocity. 

Now we have variables, you can start to build up the 
script. Return to the Scripts tab, then click on Control 
in the blocks palette. Begin by dragging a When green 
flag clicked block into the main script area. 

To make sure that Mooncake starts at the top of the 
screen at the start of the program, youTl need to set 
the coordinates. Use a go to x: o y: o block from the 
Motion blocks area. Drag it over and clip it beneath 
When green flag clicked, then enter x as o and 
y as 148. 

Next, you will need to store some data inside your 
variable blocks. To do this, use a set gravity to o block 
from the Variables area and replace the value with 
-9.81, which is the calculation of the force of gravity 
on Earth. Similarly, set the velocity variable to o. 

The simulation ioop 

In this program you want to change the velocity 
variable to simulate how gravity works. In physics, 
there are lots of mathematical equations that we 
use to calculate different forces, including gravity. 

To change the velocity variable you can use the 
following calculation: 

Velocity = Gravity x Timestep 

Velocity = -9.81 x 0.1 

The value 0.1 is a time step in this program, so that 
each time around the loop it will be multiplied by 
gravity (which is -9.81) and output the velocity. 

Dock a forever block from the Control section 
beneath your set velocity block and place a change 
velocity by o Variables block inside the forever loop. 
Next, take a multiplier Operators block (o * o) and 
place it inside the space at the end of the change 


velocity by block. Drag the gravity variable and place 
it in the right side of the multiplication operator, and 
then type 0.1 in the other. 

The last block needed is a Motion block to move * " 

the Mooncake sprite. Use the change y by motion 
block and add it into the loop, then drag the velocity 
variable and add it into the white space in the change 
y by block. The script should look like Fig 01. Save your 
program and click the green flag to check that it works. 

The program so far simulates gravity by dropping 
Mooncake from the top of the screen to the bottom, but 
she isn’t landing on the carefully drawn Earth. You can . ’ , 

change this by adding a conditional statement inside 
the simulation loop. 

Select the Control blocks area and drag an if block 
onto the scripts area. Place it inside the forever loop, 
wrapping around the set velocity and change y by • 

The program so far simulates 
gravity by dropping Mooncake 
from the top of the screen... 


blocks. Next, set your condition to the if block using 
a not operator block, which should be placed into the 
diamond shape next to the word if. Then take the 
touching color? Sensing block and place it into the 
space in the not operator block. 

The colour shown in the touching color block needs 
to match the Stage background green colour of Earth. 
To match them exactly, click on the coloured box inside 
touching color and the mouse pointer will transform 
into a little eye-dropper icon. Move your mouse onto 
the Earth in the Scratch preview window and click on 
the green colour. The block will change to display the 
same colour. Your blocks should look like they do in 
Fig 02. Save your program and click the green flag to 
see if Mooncake will land on the Earth. 

Try to figure out how you can make Mooncake jump 
when she’s on the planet, using the space bar! We’ll 
give you a hint: look at Fig 03... 
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background in Scratch, click on Stage in the sprites 
palette and then click on Backgrounds next to the 
Scripts tab. 

Click on Paint to draw your own background, or 
Import to use the same images as this resource. 
Connect your Raspberry Pi to the internet and you can 
download a space background (magpi.cc/iMYZBcx) 
and Tim Peake astronaut sprite (magpi.cc/iMYZDRs). 
Save them somewhere that you will be able to find 
them on your Raspberry Pi. 

Next, add a new sprite by clicking on the import 
a new sprite icon on the sprites palette (which 
looks like a star coming out of a folder), selecting 
Astronaut-Tim from the choices and clicking OK. 

Save your Scratch project work by clicking on File 
and Save As. Name your progam Astronaut Reaction 
Game and save it in your home directory or some place 
that you can find it later. 

Begin the game script 

First, click on your Astronaut-Tim sprite to select 
it in the sprites palette. Select the when green flag 
clicked Control block from the blocks palette and 
place it onto the scripts area, then click on Looks and 
connect the say for 2 secs block to the first control 
block on the scripts area. Amend the text to say: 

‘Hello! British ESA Astronaut Tim Peake here. Are you 
ready?’. Add a wait 1 secs Control block underneath 
and then connect another say block and change the 
text for it to ‘Hit Space!’. 

Next, click on Sensing and connect the reset timer 
block. This will set the timer to o so that you will get 
an accurate measurement of how long it takes for 
someone to hit the space bar. Use the Control block 
wait until and place a key space pressed Sensing 
block inside the white space of the wait until block. 
This will pause the program until the player presses 
the space bar. 

Connect another say block. Once the space bar 
has been pressed, you want to display the reaction 
time to the player. To do this, you need to place an 


Operators block called join hello world inside the 
white space in the say block. Replace the word ‘world’ 
with the word ‘seconds’. 

You will then need to replace the word ‘hello’ with 
another join hello world Operators block, replacing 
the ‘hello’ text with ‘Your reaction time was ’, and the 
‘world’ text with the timer Sensing block. 

Make a new variable called time, then select the set 
time to Variables block and add it to the script. Place 
the timer Sensing block in the 0 space (Fig oi). Save 
your game and test it out by clicking the green flag. 
When Tim says “Hit Space!”, press the space bar. 


Above Left This 
is similar to the 
sort of training • 
Tim will be 
doing on the 
International 
Space station 


Program the distance 
linked to your reaction time 

If you are happy with the reaction game so far and 
have tested that it works, then you can move onto 
adding to the script to compare the player’s reaction 
time to the speed at which the ISS is travelling, to 
calculate how far it would travel in that time. 

First, you will need to make a new variable called 
distance, in the same way you did earlier. Attach a 
set distance to Variables block to your script. Place 
an Operators multiply block 0*0 inside where it reads 
0. To calculate the distance travelled by the ISS, you 
need to take the player’s reaction time, stored in the 
time variable, and multiply it by 7. This is because, on 
average, the ISS travels 7 kilometres per second. 

Add the time Variables block into the right-hand 
side of the multiplying operator and type 7 in the 
other side, so the whole block reads set distance to 
time * 7. Next, add a wait 4 seconds Control block. 
Add a say block. As in the previous step, place a 
join hello world block inside. Replace ‘world’ with 
‘kilometres’. Insert another join hello world block 
to replace ‘hello’. Replace the ‘hello’ text in this new 
join block with the text ‘In that time the ISS travels 
around ’. Then replace ‘world’ with a round Operators 
block and fill the white space with the distance 
Variables block, as in Fig 02. Finally, save your game 
and test that it works by clicking on the green flag. 
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PI-TOP 


pi-top. com 


£195 / $300 



PI-TOP 


A laptop built from a Raspberry Pi and crafted yourself. 

Is it too limited by the Pi, or is it a great little portable teaching tool? 




KANO 

Similar in terms 
of gamifying 
programming 
education 
and building, 
although it’s not 
the all-in-one 
product pi-top is. 



O t’s really not that old, but 
do you remember the One 
Laptop Per Child (OLPC) 
project? It was a cheap laptop 
with yesteryear’s components, 
created specifically to try to make 
getting computing into the poorest 
of developing nations as easy 
as possible. It was also very green, 
and we don’t mean ecologically 
- although it was also quite 
low-powered, so it technically 
is ^green’ in that sense. When 
we got the pi-top out of its box, 
that was the first thing that came 
into our minds, but definitely not 
in a bad way! 

The elevator pitch for the pi-top 
is that it’s a crowdfunded laptop 
kit that the user needs to assemble, 
which is powered by an included 
Raspberry Pi. There’s a lot more to 
it, though, and we’ll get into that 
shortly, but already this gives you 
a basic impression of what we’re 
dealing with. 


Brush away thase 
first impressians 

The pi-top has a big educational 
focus built into it. Each pi-top 
user has to create a cloud account 
before logging in, which then syncs 
settings and such to this account. 

It also syncs data from CEED 
Universe, the gamified learning 
software that is custom-made to 
meet the new GCSE curriculum. 
This, on top of the usual Raspberry 
Pi teaching resources, gives it an 
edge in the classroom, as students 
can use whatever pi-top they want 
without having to carry too much in 
the way of data around with them. 

It sounds great in theory. Let’s 
first go back to the box opening, 
though, before we start discussing 
its other merits. The box itself is 
lovely, with the first thing you see 
being the detached laptop screen’s 
bright green back with the pi-top 
logo in it. All the parts are stored in 
layers, carefully packed with a soft 


foam. You’ll have to look carefully 
to find the laser-cut removable 
circuit cover and the selection of 
required screws and cables, but 
they’re all there. 

The instructions, and indeed 
the assembly, are quite simple. 
There are three main parts of 
the laptop chassis, and only two 
pieces of circuit board including 
the Raspberry Pi, so the majority 
of the process is preparing and 
fitting the parts together. While 
the instructions are generally 
good, they don’t distinguish very 
well between the two types of 
screws. Hint: the screws that look 
like motherboard spaces need 
to be affixed to the PCBs; they 
have a thread running down the 
centre of the head. Also, one of 
the connection orientations is 
not completely clear. We found 
ourselves having to take it apart a 
bit so we could construct it properly 
at one point. 
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PI-TOP 



'Maher 

Sagi 

Use me 
to ploy, learn, 
□nd create! 

Pi-Top 




It looks great and works absolutely 
fine, thanks to the extra oomph 
of the Pi 2's processor 


If 


Otherwise, assembly was quite 
quick. We stuck on Netflix and 
after a couple of episodes of Bojack 
Horseman it was ready to boot up, 
so less than an hour and probably 
quicker without giggling every 
minute. Make sure all the ports and 
cables are properly connected and 
you can turn it on for the first time. 

It’s quick and easy to set up 
an account the first time, and 
you get some choices as to what 
software you want to be able to 
quick-launch from the panel. The 
pi-topOS is a custom interface 
built on top of Raspbian Wheezy 
that has a different offering of 
default software, albeit with full 
access to the standard packages 
you can get on Raspbian anyway. 


The interface is roughly the same 
as normal Raspbian’ s, but with the 
panel down at the bottom and a 
bit more of an OS X vibe with some 
of the display characteristics. It 
looks great and works absolutely 
fine, thanks to the extra oomph of 
the Pi 2’s processor; the only issue 
we had was that the Chromium 
browser selected by default is still 
a little too slow. 

The CEED Universe, currently in 
early alpha at the time of writing, 
is quite interesting. Taking the 
resource-gathering and building 
elements from Minecraft, and 
applying them to a top-down 
aesthetic from early nineties PC 
games as a way to teach coding and 
physical computing, is fairly unique. 


Players are asked to perform Python 
coding tasks as part of the game, 
starting off with something akin 
to Hello World. It’s very gamified, 
and the final version could be really 
something if done right. 

The pi-top, then, is a great piece 
of kit. While it’s probably not going 
to replace a normal laptop in a 
similar price range, it’s an excellent 
educational tool. It’s also a portable 
Raspberry Pi with a ten-hour 
lifespan, which is pretty great on its 
own. Hopefully, it will make its way 
into classrooms or into the hands 
of budding young coders. 


I^word 

Makes great use of the Raspberry Pi to create 
a fully functional laptop that you build with 
your own hands - the entire system is a great 
experience for those wanting to learn. 

★★★★★ 


w 
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TENMA BOW DIGITAL SOLDERING STATION 


iUaher 

Sagi 

Provides 

almost 

instant 

working 

temperatures 

Tenma 




TENMA 60W DIGITAL 
SOLDERING STATION 


Gareth Halfacree sees if degree-accurate temperature 
control has a place in the hobbyist soldering toolkit... 


O readboards are all well 

and good for prototyping, 
but there comes a time in 


‘Related 


WELLER 

SP25N 

For small 
soldering 
jobs, a good 
quality fixed- 
temperature 
iron like this 
Weller SP25N 
is a cheaper 
alternative to a 
bulky soldering 
station. 



every electronics hobbyist’s life 
when it’s time to melt some metal 
and start soldering something 
together. Whether it’s fixing 
something that’s broken or 
building something new, soldering 
is an important skill, and one 
which can be made easier or harder 
depending on the tools you choose. 

The Tenma 60W Digital Soldering 
Station is designed to bridge the 
gap between ultra-cheap fixed- 
temperature irons which are the 
mainstay of hobbyist solders, 
and the high-end, finely tuned 
tools you’d find at a professional 
engineer’s workstation. Selling 
for sub-£50/$70, the feature 
list is nevertheless impressive: 
the hefty base unit provides 
control of the iron temperature 
between a minimum of 150°C and 


a maximum of 450°C, either by 
flipping between three preset 
temperature levels or by setting 
your own, and it boasts a stability 
of ±i°C with 60W of power 
to back it up. 

To get something out of the 
way early on in this review: no, 
you almost certainly don’t need 
a highly accurate, temperature- 
controlled soldering station. It can, 
however, make life easier. If you’ve 
ever tried soldering and found that 
sometimes the solder just doesn’t 
want to flow - in particular when 
making large connections - then 
you’ve experienced the frustration 
of using an underpowered iron 
that couldn’t supply the heat fast 
enough. If you’ve watched an LED 
or other heat-sensitive component 
go up in smoke during soldering, 
then you’ve experienced the 
flip side: an iron which delivered 
too much heat. 


Temperature-controlled 

A temperature-controlled iron 
solves all that. You can set the 
temperature just right for the 
solder you’re using, and it will be 
tracked and adjusted by the on- 
board controller. If a large joint is 
drawing heat away from the tip too 
quickly, the output is increased; 
if the tip gets too hot, the output is 
decreased. The aim is temperature 
stability of a single degree. It’s a 
powerful feature, and a definite 
step up from cheaper variable- 
temperature irons which don't 
adjust their output automatically. 

As an entry-level example, 
though, you’d expect to see some 
corners cut in Tenma’s build. 
Looking at the base unit, they’re 
not obvious: the unit is solidly 
built and includes a physical 
power switch, while the large 
backlit LCD display at the front 
is clear and easy to see while 
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TENMA BOW DIGITAL SOLDERING STATION 



l^word 

With such a small cost 
premium over a quality fixed- 
temperature iron and a fair 
list of advantages, if you fancy 
treating yourself to an iron 
upgrade, you could do a lot 
worse than the Tenma. 

★ ★★★★ 


The iron itself is lightweight, 
since the electronics are 
located in the base unit 


alternative tip-cleaning system - 
as soon as possible. 

These points aside, though, the 
Tenma soldering station is a joy 
to use. Its 6 oW output and dual 
heating coils mean the iron’s 
tip - which is easily replaceable 
through a quick twist of a retaining 
nut, with various shapes and 
sizes available - comes up to 
temperature rapidly. Plus, the live 
temperature readout on the base 
unit means there’s no guesswork 
when it comes to seeing whether 
it’s ready for use or not. 

Another feature is Tenma 's 
claim to electrostatic discharge 
(ESD) safety. This is the promise 
that - unlike extremely cheap irons 
often found in starter kits and 
from bargain-basement shops - 
there’s no risk that a blast of static 
electricity will fry any sensitive 
components as you touch the 
metal tip of the iron to one of their 
contacts. It’s a problem unlikely to 
have affected most hobbyists, but 
the reassurance it won’t bother you 
in the future is undeniably nice. 


soldering. A multi-pole connector 
provides power to and feedback 
from the iron, which is a small 
and lightweight unit thanks to 
the bulk of the electronics being 
located in the base unit. The only 
real negative here is that the unit 
is fixed to the power network 
of the country of purchase - 
either 220V or iioV - and its 
power lead is integrated rather 
than removable. 


Saving pennies 

It’s not until you look to the 
bundled stand that you begin to 
see where Tenma has been saving 
its pennies. While the stand itself 
is a sturdy metal housing, it fails 
to grip the iron adequately, largely 
thanks to the lack of weight in the 
iron and the relatively heavy lead 
which connects it to the base unit. 
It’s functional, but care is needed 
to make sure the iron doesn’t 
drop out. The bundled cleaning 
sponge, meanwhile, is barely 
adequate, and should be replaced 
with something thicker - or an 


Above The cleaning 
sponge isn't great 

Above top The large 
LCD is clear and 
easy to read 
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RASPBERRY PI 

BESTSELLERS 


A PACKT AUTUMN 


Autumn started with more than a dozen 
Pi-relevant tities from Packt. These three 
are flying off the shelves... 



RASPBERRY PI LEO 
BLUEPRINTS 


Author: Agus Kurniawan 
Publisher: Packt 
Price: £i 9-99 
ISBN: 978-1782175759 

magpi.cc/iSNfIZy 


Never underestimate the power 
of switching on a Light by code 
to attract children to coding. 
Kurniawan's book harnesses 
this magic to introduce a range 
of GPIO and I^C programming 
techniques. 


Authors: Gokhan Kurt 
Publisher: Packt 
Price: £22.99 
ISBN: 978-1785887024 
Imagpi.cc/iSNfQbul 


A short but handy roundup of 
many ways that your Android 
device can be used with a 
Pi 2, from remote desktop and 
sensors, through surveillance 
cameras and media centres, to 
collecting automotive data. 



RASPBERRY PI ANDROID 
PROJECTS 


PYTHON GAME 
PROGRAMMING 
BY EXAMPLE 

Authors: Joseph Howse 
& Alejandro Rodas de Paz 
Publisher: Packt 
Price: £25.99 
ISBN: 978-1785281532 
magpi.cc/iSNfVfd 


Classic games, useful 
Libraries, and essential 
algorithms: Rodas and Howse 
build your knowledge through 
well-chosen combinations of 
all three, then add computer 
vision with OpenCV as the 
icing on the cake. 




FLUENT 

PYTHON 


Author: Luciano Ramalho 
Publisher: O'ReilLy 
Price: £33 50 
ISBN: 978-1491946008 
oreiLly/iFAcbtb 


There are now a few 
books to answer 
that Vhere do I go 
next with Python?’ question, but 
Fluent Python makes a persuasive 
case for a place on your bookshelf 
or SSD. Ramalho delivers all of 
the good things about Python that 
you may miss when coming from 
another language, as Python has 
many features that are unique or 
only found in a few languages. All 
this without straying far from the 
core language and standard library. 

From the power of slicing 
operators on lists, through duck 
typing on the Vector Space Model, 
to unlocking some of the powerful 

PYTHON PARALLEL 
PROGRAMMING 
GOOKBOOK 


Author: Giancarlo Zaccone 

Publisher: Packt 

Price: £ 31-99 

ISBN: 978-1785289583 

magpi.cc/iSNgPYZ 


but poorly documented features 
in Python, like coroutines, every 
chapter contains something to 
make you a better programmer. 
Some will impress straight 
away, while others make 
subtle improvements to your 
future code. 

Fluent Python is split into six 
sections, books-within-the- 
book. The first gives essential 
insights into the data model, 
the rest can be read in any 
order as desired; it covers topics 
such as collections (sequences, 
mapping, sets), functions as first 
class objects, building classes, 
generators, concurrency, and 
much more. The REPL is used 
throughout for hands-on learning, 
and there are many glimpses into 
the workings of the very welcoming 
Python community. Destined to be 
another O’Reilly classic. 



^Ihon 




A cookbook but 
also a tutorial, teaching parallel 
programming with the aid of Python 
as much as parallel programming 
with Python. Python 3 is used in all 
but the GPU programming chapter, 
which mostly uses Nvidia’s CUDA 
- not relevant on the Pi - but it also 
covers PyOpenCL. 

The introductory chapter delves 
into Von Neumann architecture and 
shared memory schemes to build a 
picture of the parallel programmer’s 
operating environment, then 
tackles Python’s biggest problem for 
concurrent programmers, the Global 
Interpreter Lock (GIL). Starting with 
the threading package for traditional 


Score ititititit 


multi-threading, Zaccone goes 
from how to do it to how it works 
in each example, building through 
semaphores, conditions, 
and queues. 

He moves onto process- 
based parallelism, with 
a useful exploration of 
collective communication; 
asynchronous programming, 
including Python 3.2’s 
concurrent. futures module, 
Asyncio to manage events 
and coroutines, task manipulation, 
and the Future class; the Celery 
framework to handle distribution 
across machines, and other useful 
libraries. Occasional idiosyncrasies 
in English usage - not the author’s 
first language - could have been 
tidied up, but technical content is 
spot on and worth the rare need to 
re-read a sentence for clarity. A good 
introduction and useful reference on 
parallel programming. 


Score ★★★★★ 
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ELECTRONICS 

WORKSHOP 


Author: Stan GibiLisco 
Publisher: Tab Electronics 
Price: £18.99 
ISBN: 978-0071843805 
magpi.cc/iSNgXrF 


Stan Gibilisco has 
been writing on, and 
tinkering with, electronics for a 
long time, so this short reference 
and introduction benefits from 
distilling decades of experience, 
showing a clarity of approach that 
indicates a writer and tinkerer with 
plenty to pass on to newcomers. 
The opening chapter on ^Setting 
up Shop’ is a pleasingly minimalist 
alternative to the Ve assume you 
have a giant spare room and lots 
of money’ approach of some other 
maker introductions. 

Although ideal for newcomers 
- and it can be read linearly - 
there’s plenty of useful reference 
and tips worth dipping into for 

LEARN GAME 
PROGRAMMING 
WITH RUBY 


those who’ve been soldering since 
the NE555 was a hot new chip. 
Remaining chapters are organised 
by topic in the expected 
manner: Resistors, 
Capacitors, Inductors, 
Transformers, Diodes, 
Transistors, ICs and Digital 
Basics, More Components 
and Techniques, followed 
by useful appendices and 
further reading. 

What really makes the 
book stand out, in addition to 
the clear explanations, is the 
experiments at the end of each 
chapter, which combine practical 
use of components and tools with 
demonstrating various bits of 
electronic theory which would be 
quite dry and dusty if taught only 
as theory. For example, in testing 
a JFET, you gain understanding of 
where electrons should and should 
not flow. 


Author: Mark Sobkowicz 
Publisher: Pragmatic 
Price: £i 5-99 
ISBN: 978-1680500738 
orelLly/iOlpRoN 




» w 


From the contents, 
introduction and content of 
Sobkowicz’ s otherwise useful 
introduction to 2D game 
programming, you’d think the 
GNU/Linux platform didn’t exist. 
Windows and Mac OS X get a chapter 
each, but Raspbian’s Linux relatives 
don’t even make a footnote in an 
appendix. Fortunately, you can 
find full instructions on installing 
the Gosu library used in the book 
on Raspbian (or Ubuntu, et al) at 
github.com/gosu - we used rbenv 
to install Gosu on Ruby 2.1.2. That 
done, turn to chapter three, because 
Ruby Game Programming still has 


Score ififififif 


plenty to offer on the Pi. This isn’t 
a book about Gosu, or even solely 
about Ruby, but about the 
various techniques 
used in programming 
2D games, which 
encompass a wide 
range of gameplay 
and perspective. And 
Python’s expressive and 
slightly less buttoned-up 
cousin Ruby makes a good 
language for introducing them: it’s 
concise and easy to read. 

Introducing sprites, interaction, 
platform gaming and sideways 
scrolling, Sobkowicz is an able 
guide to all the components and has 
written a book suitable for early- 
stage coders of all ages. Niggles 
about leaving Linux users out in 
the cold aside, this is a practical 
and enjoyable introduction 
to game programming. 


Score 


ESSENTIAL READING: 

COMPSCI ESSENTIALS 

Recent academic tames ta baast yaur brain 
pawer, with Pythan far CampSci iearning. 


introduction to Computing 
Using Python 

Author: Ljubomir Perkovic 
Publisher: Wiley 

Price: £159.99, or £29.16 for e-book 
ISBN: 978-1118890943 
magpi.cc/iSNieiu 

Welcome update to the breadth- 
first computer science introductory 
textbook, with a strong focus on OOP. 




Discovering Computer 
Science 


Author: Jessen Havill 

Publisher: Chapman and Hall/CRC 

Price: £ 57-99 

ISBN: 978-1482254143 

magpi.cc/iSNijTe 


Computational thinking as "a powerful 
mode of inquiry and a vehicle of discovery, 
in a wide variety of disciplines." 


Doing Moth with Python 

Author: Amit Saha 

Publisher: No Starch 

Price: £i 9-99 

ISBN: 978-1593276409 

nostarch.com/doingmathwithpython 

Pre-computer science; catch up on 
high-school mathematics, and have fun 
with Python along the way. 



I Computational Physics 

Author: Rubin H Landau, 

ManuelJ Paez & Cristian C Bordeianu 

Publisher: Wiley 

Price: £75.00 

ISBN: 978-3527413157 

magpi.cc/1SNiw95 

Pythonic reworking of a classic that's 
essential for any physics student. Useful 
maths and programming for all scientists. 

Making Music with Computers 

Author: Andrew R Brown 
& Bill Manaris 

Publisher: Chapman and Hall/CRC 
Price: £ 31-99 
ISBN: 978-1439867914 
magpi.cc/1SNizl7 

Computer science introduction for a non- 
traditional audience, using music creation 
I with Python in a Jython environment. 


Physics 


, -.V* 
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Community 


FEATURE 


CODING BACK 
THE YEARS • 


The Raspberry Pi Foundation has merged with Code Club in the continuing 
quest to educate children and right some past wrongs 


Below Code Club 
CEO Clare Sutcliffe 
is excited by the 
opportunities the 
merger presents 


O n 2012, two organisations 

embarked on a path towards 
a computing revolution. 

The Raspberry Pi Foundation began 
selling the credit card-sized single- 
board computers that we have come 
to know and love, and Code Club was 
established to teach children aged 
9-11 how to program. 

Since then, the numbers have 
stacked up. Some 7 million 
Raspberry Pis have been sold, and 
there are now 3,800 Code Clubs in 
the UK alone, with 1,000 more in 
70 other countries. There is also a 
greater awareness of the benefits of 
coding, thanks to a new computing 
curriculum in England. 

It therefore makes sense for the 
two organisations to work closely 
together. In November, Philip 
Colligan, CEO of the Pi Foundation, 
announced a merger with Code Club, 



and the deal looks set to reinvigorate 
the drive to encourage more 
youngsters to get under the hood 
of their machines. 

Ve been a huge fan of Code 
Club for a long time,^^ Philip tells us. 
^^They Ve got a fantastic model that 
matches volunteers with schools 
and provides them with everything 
they need to run a club. It’s simple, 
low-cost and effective, which is 
why they’ve been able to reach so 
many young people in such a short 
space of time.” 

Indeed, 44,000 children currently 
attend a Code Club, where they learn 
how to program in Scratch, HTML, 
CSS, and Python. But the new 
partnership wants to reach even 
more children, and the aim is to put 
such clubs in every primary school 
in Britain. That’s all 21,000 of them. 

have always hugely admired 
and respected the work of the 
Raspberry Pi Foundation,” says 
Clare Sutcliffe, co-founder and 
CEO of Code Club. ^When we were 
talking, it became clear that we 
both share the same mission and 
have very ambitious goals to bring 
digital making to as many people 
as possible.” 

Volunteer effort 

Code Clubs take place for an hour 
each week and children are shown 
how to produce games, animations, 
and websites. They are run by 
volunteers who embark on online 
training courses, which encourages 
a structured learning pattern over 
four terms. 


^^The merger will allow us to set 
ambitious goals and provide the 
strength, network and resources to 
achieve them,” adds Clare. ^^There 
are many in the Raspberry Pi 
community that already volunteer 
for Code Club, but 1 can’t wait to 
introduce ourselves to many more.” 

Philip is also clear that this is 
something he wants to see. ^^Code 
Clubs are a great fit with our 
mission,” he says. ^^They create 
opportunities for kids from all 
backgrounds and levels of ability 
to get involved and learn about 
programming. They’ve also got 
phenomenal reach already and 1 
think they have real potential to go 
even further. We’re serious when 
we say the goal is to put a Code Club 
in every community. ” 

Under the deal. Code Club 
becomes a wholly owned subsidiary 
of the Raspberry Pi Foundation, but 
it’ll continue to be run in the same 
way as it does today: volunteers will 
be matched to schools, free training 
will be given, and projects will 
be provided for children to work 
through at their own pace. 

Yet Philip is keen to widen the net 
of volunteers and draw in people 
from a variety of backgrounds: ^Bf 
1 had to call out one thing Code 
Club does, it’s making it easy and 
rewarding for people to volunteer. 
While lots of the volunteers are 
engineers and programmers, it’s 
also a good way for non-technical 
people to volunteer at school and 
learn how to make things with 
computers themselves.” 
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A two-pronged effort 

As such, the merger will help 
make for a more coherent, two- 
pronged effort to educate children 
in the ways of programming. ^‘The 
Foundation puts a lot of effort into 
training teachers,’’ says Philip, ^^but 
we also need to create opportunities 
for kids outside the classroom, and 
Code Clubs are a big part of that. ” 
The Raspberry Pi Foundation 
will therefore continue to offer its 
existing educational programmes, 
resources, teacher training, and 
open-source software, while 


programming grounding, then why 
have extracurricular activities? 

^^We’ve made great progress in 
England with the new computing 
curriculum, and the Foundation 
puts a lot of effort into training 
teachers. It’s great to see that 
being replicated around the world 
now,” explains Philip, think 
of it a bit like sport at school. 

We will always need dedicated 
curriculum time in the school day 
to make sure all boys and girls 
get the opportunity to participate 
in sport, but we also need after- 




It became clear that we both 
share the same mission... 


II 


the Code Clubs help to expand 
children’s knowledge in a less 
formal environment. 

It’s all part of the overall plan 
to shift children away from just 
learning how to use pre-written 
desktop software, something which 
is said to have caused a major skills 
gap during the 1990s and 2000s. 
Both the Foundation and Code Club 
want to encourage kids to write 
their own software. 

^df we’re going to tackle the 
problem of kids not learning how to 
make things with computers, then 
we need to change what happens in 
formal settings, like the classroom, 
and informal settings, like clubs 
and people’s homes,” says Philip. 

But is the Foundation’s 
merger with Code Club an 
acknowledgement that children are 
still not being taught adequately in 
schools? After all, if young people 
are already being given a solid 


school and weekend amateur 
clubs, and those will often be 
led by volunteers.” 

He says Code Clubs are 
perfect for children who show 
a real talent: ^We want to have 
programmes that help them 
advance their skills and ultimately 
make successful careers. Making 
things with computers needs the 
same kind of ecosystem. Code Club 
is a first step in creating that.” 

Clare agrees: ^^Code Clubs give 
children the opportunity to use 
their new digital skills in a sociable 
environment, on creative projects 
they can fully engage with. The 
opportunity to practise new skills 
is as important as being taught 
in the first place. What Code Club 
tries to do is facilitate the setting 
up of such groups for children, 
and 1 am so excited that we are 
trying to meet our goals with 
the Raspberry Pi Foundation. ” 


DIGESTING 
MORE THAN PI 

Since they were set up in 2012, Code Clubs have 
been platform-neutral. This will remain the case 
under the merger, with teachers, volunteers and 
children encouraged to use the best hardware and 
software available for their students. They will not be 
forced to use a Raspberry Pi. But why? 

"Schools have different levels of resources 
available, and students have different levels of 
capabilities," explains Philip Colligan, CEO of the 
Raspberry Pi Foundation. "Our job is to provide 
them with the best support we can." 

He says this is an important point for the 
Foundation as a whole. "Of course, a lot of our work 
focuses on the Raspberry Pi computer as a tool for 
education, and it always will. But our mission and 
activities are much broader than that, and many of 
our programmes, like Code Club, are designed to 
be platform-neutral... Sonic Pi is a great example. 

It works brilliantly on the Raspberry Pi, but you can 
also use it for free on a Mac or PC." 

Clare Sutcliffe, co-founder and CEO of Code Club, 
wholeheartedly agrees, believing a platform bias 
would only hamper the progress of children. "It’s 
important that we remain platform-neutral so that 
our projects can be accessible to as many schools 
and venues as possible. The requirement for specific 
hardware or platforms for our core curriculum could 
exclude venues who might not be able to afford to 
change their current kit." 
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Community 


RASPBERRY PI DC 


Washington, D.C, USA 


RASPBERRY JAM 
SILICON VALLEY 


Mountain View, CA, USA 


*! EVENT 
CALENDAR 


Find out what community-organised, 
Raspberry Pi-themed events 
are happening near you... 


Want to add your get-together? List it here: 

raspberrypi.org/jam/add 




PI WARS 

When: Saturday 5 December 
Where: Cambridge Computer 

Laboratory, Cambridge, UK 

piwars.org 

Watch these Raspberry Pi- 
powered robots battle it out 
in feats of manoeuvrability 
and precision. 



A SLICE OF PI CLUB 

When: Tuesday 8 December 
Where: The Hexagon, 

Redditch, UK 
magpi.cc/i06QEuI 
A series of events aimed to bring 
like-minded people together to 
learn about the wonderful world 
of the Raspberry Pi. 



RASPBERRY PI DAY 

When: Saturday 12 December 
Where: University of Strathclyde, 
Glasgow, Scotland, UK 
magpi.cc/1MG9kCx 
The Raspberry Pi day is an 
event for all levels of ability and 
involvement to learn about the 
Raspberry Pi. 



PRESTON RASPBERRY JAM 

When: Monday 7 December 
Where: Media Innovation Studio, 
Media Factory Building, 
Preston, UK 
magpi.cc/iMG6KMH 
A family- friendly event to get 
people introduced to the Raspberry 
Pi, and for enthusiasts to meet up. 



CHRISTMAS RASPBERRY PI 

When: Wednesday 9 December 
Where: University of Greenwich 
- Medway Campus, 
Chatham, UK 
magpi.cc/i06RkjH 
A Christmas-themed 
Raspberry Jam, just in time for 
the holiday season. 



RASPBERRY PI DC 

When: Thursday 17 December 
Where: Difference Engine, 
Washington, DC, 

USA 

magpi.cc/1MG9xFE 

A presentation on Windows 10 
and loT that can be used 
with Grove Pi. 
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RASPBERRY JAM 
SILICON VALLEY 

When: Saturday 19 December 
Where: Computer History Museum, 
Mountain View, CA, USA 
magpi.cc/i06SHin 
A monthly Jam in the heart of 
Silicon Valley. Maybe youhl 
find a startup or two. 



LEEDS RASPBERRY JAM 

When: Wednesday 6 January 2016 
Where: Swallow Hill Community 
College, Leeds, UK 

magpi.cc/i06SITu 

This Jam aims to bring people together 
from across a wide area to discover 
the potential of the Pi through talks, 
demos, and hands-on workshops. 


DON'T 
MISS: L 


WARS 


When: Saturday 5 December Where: Cambridge Computer Laboratory 


The second CamJam Pi Wars is □ 
chaiienge-basGd robotics competition 
in which Raspberry Pi-controiied 
robots compete in various choiienges 
to earn points, with prizes awarded 
at the end of the day. Lost year there 
were 20 teams taking port, inciuding 
schoois, fomiiies, and hobbyists. This 
onnuoi event offers fantastic fun for 
participants and spectators aiike. 

For more detoiis, visit piwars.org. 
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Community 


FEATURE 


THE MONTH IN 

RASPBERRY PI 

Everything else that happened this month in the world of Raspberry Pi 



SPOOK'AIcfONT 

3R>R«PBERRY 


As we finish writing this issue of The MagPiy we Ve just 
experienced another frightfully excellent Halloween. 
You may remember in issue 38 that we had an entire 
feature on scare-tastic Halloween projects powered 
by Pi, and it seems as though many people were at it-^ 
again this year with more horrifying Pi projects. Brace 
yourselves^ as we show you some, of our favourites that 
were tweeted at us. . . 






HALLOWEEN PUMPKIN 

STEWART WATKISS / PENGUIN TUTOR 

twitter.com/stewartwatkiss 

youtu.be/Yy6c2NUA1Fw 

Stewart was the man who made the Haunted House we 
featured in our original Halloween article in issue 38, 
posing as Count Dracula and simulating a veritable 
monster mash in his garage. This year he’s gone a 
little smaller scale by hacking some pumpkins to show 
a variety of colours. The pumpkins are carved and 
have NeoPixels put in, which shift and change colour 
so that neither pumpkin is ever the same shade at 
once. It creates an eerie effect that really makes the 
pumpkins stand out even more. 


ifj : 

I PI-CONTROLLED GHOST > 

ASTRO DESIGNS | 

twitter.com/AstroDesignsLtd 

youtu.be/WLD0Ysn7YrA 

This one must have been genuinely quite sjiary (we gave 
it a 4/5 on our SPOOK-O-METER on our Tv\jitter), and 
apparently took Astro Designs a couple of late nights to 
get it working before the big day. The floating, flickering 
and screaming ghost, as they describe it, is made of a 
Pi, some Lego, and a fan to keep it aloft. Wd definitely 
wouldn’t have wanted to come across that while trick- 
or-treating one cold October evening. . . 

HALLOWEEN PAINTING 
WITH MOVING EYES 

PIBORG 


magpi.cc/iLbAuf6 


This one is a bit of a classic, 

although it reminds us a > 

bit more of Scooby Doo “ 

than any of the old horror 

movies it was popularised * 

by. The robotic geniuses S 

at PiBorg cut out the f 

eyes of an already quite 

creepy portrait print and then mounted them on a 
magnetically controlled moving frame. This was then 
mounted to the frame the actual picture. The result 
is a Pi-powered shifty-eyes ghost portrait for all your 
dramatic close-up needs. 
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THIS MONTH IN PI 


CROWDFUND 

THIS! 


The best crowdfunding hits this 
month that you should check out. . . 



PIPLAY DESKCADE 


kck.st/iGfmWU2 


We know what youhe thinking - another arcade 
machine case for the Raspberry Pi, and another one 
that’s being Kickstarted. This one is a little simpler, 
and comes with a much bigger screen than some of 
its spiritual predecessors. At the time of writing, it’s 
already hit its goal and will be just about finished 
when you read this. However, we think it’s one you 
should be keeping an eye on for Christmas presents 
for the retro gamer in your life. 



TINGBOT 


kck.st/iSipiDv 


Using the Raspberry Pi for the Internet of Things 
is not a novel concept, but the Tingbot takes this 
basic premise of an loT Raspberry Pi and expands on 
it. Using a custom 3D-printed box and very simple 
programmable interface, you can create your own 
personal box of tricks in what’s promised to be an 
easier way than normal. It reminds us a bit of computer 
assistants in sci-fi movies, although you’ll be doing a 
bit more of the legwork. The Kickstarter is still going, 
so let us know what you think. 


BEST NEW 


PRODUCTS FOR PI 

These Raspberry Pi add-ons and kits can be bought right now, 
and will make using your Pi so much better 



MAKER-SPHERE1 


STARTER KIT 


A Raspberry Pi starter kit from the folks at SB Components, the 
Maker-Sphere comes with a Raspberry Pi and i6 accessories that allow 
you to not only get the Pi up and running perfectly, but also start on your 
first ten projects. Quite unique to this kit is the inclusion of the new Sense 
HAT, the add-on board with environmental sensors that’s being sent to 
the International Space Station for Astro Pi. There’s also a breadboard for 
creating solderless circuits and a few components to go with it. 

You can also sign up for the Maker-Sphere Project Club once you have 



An add-on for the superb Pi-DAC+ we reviewed in issue 37, the main draw 
of the Pi-AMP+ is how it adds two 35W stereo outputs to the Raspberry 
Pi to really improve the sound coming out of it. It’s perfect for creating 
a mini-portable hi-fi or powering your in-home sound systems. It’s quite 
smart as well, and knows if you’ve plugged your headphones into the 
Pi-DAC+ underneath so it can turn itself off. While it does require its own 
power source, it will power your Raspberry Pi while turned on, so at least 
you’re not doubling up on power cables. 
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TAKE US 




DOWNLOAD ALL 30 ORIGINAL ISSUES 



for smartphones & tablets 


Get it on 

Google play 


£ 2.29 £ 19.99 

rolling subscription full yeor subscription 

Download it today - it's free! 

Get all 30 legacy issues free 
Instant downloads every month 
Fast rendering performance 
Live links & interactivity 


Available on the 

w AppStore 
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In association with: 



Open a world of opportunities 


LCD CONTROL 
CASE BUNDLES 

MUST BE WON! 



WHAT WOULD 
YOU MAKE 
USING THE 

CONTROL 
CASE BUNDLE? 


THE 

BUNDLE 

INCLUDES: 


> lx 3.2" LCD TFT 
screen 

> lx Protective case 
with mounting 
points for 
Raspberry Pi 2 

>ix USB WiFi 
dongle 

> lx Power supply 
(with 3m cable) 

> lx microSD card 
preloaded with 
LCD software 


r 



Tell us by 21 December 
for your chance to win! 


Simply email competition@raspberrypi.org 

with a lOO-word (max) overview of your project idea. 


How to enter: 


Terms & Conditions 

Competition closes 21 December 2015. Prize is offered worldwide to participants aged 18 or over, except employees of the Raspberry Pi Foundation, the prize supplier, 
their families or friends. Winners will be notified by email after the draw date. By entering the competition, the winner consents to any publicity generated from the 
competition in print and online. Participants agree to receive occasional newsletters from The MagPi magazine (unless otherwise stated upon entry). We don't like 
spam. Participants' details will remain strictly confidential and won't be shared with third parties. Prizes are non-negotiable and no cash alternative will be offered. 
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THE FINAL WORD 


MAH RICHARDSON 

Matt is Raspberry Pi’s US-based product evangelist. Before 
that, he was co-author of Getting Started with Raspberry Pi 
and a contributing editor at Make: magazine. 


A TINY 
COMPUTER 
WITH BIG IMPACT 


Matt Richardson loves Raspberry Pi Zero’s low price, 
small size, and maker-friendly features 


O f you’re reading this month’s issue of 

TheMagPi in print, you’re holding a tiny 
piece of Raspberry Pi history in your hands. 
Could you have ever imagined that a Linux 
computer could be small enough to be attached 
to the front cover of a magazine? Could you have 
ever imagined that you’d be able to purchase a 
computer that runs a full-featured desktop operating 
system for just five dollars? Or could you have ever 
imagined that it would be so easy to embed such a 
tiny computer into your own project? The size, price 
and maker-friendly features of Raspberry Pi Zero 
make it a groundbreaking product for our Foundation 
and our community, and we’re so excited to share 
it with you. 

Making affordable computers is one way that we 
make computing more accessible, especially for 
children. Raspberry Pi Zero is an experiment in 
taking that affordability to extremes. At risk of 
sounding like I’m making an appeal for donations, 
for the cost of two candy bars, you can now buy your 
own computer. 

Each time we decrease the price of a computer, 
there’s likely to be a huge increase in the amount 
of people who can afford one to experiment with. 
Increasing these opportunities is a major part of 
what the Raspberry Pi Foundation is all about. 

I’ve had a Raspberry Pi Zero for a few weeks now 
and 1 still haven’t become accustomed to the tiny size 
of this powerful computer. Back when the Model A+ 
was originally released, 1 was delighted that it could 
fit into an Altoids tin. These pocket-sized mint tins 
are a popular enclosure for small electronics projects. 
Now, not only can you easily fit a Raspberry Pi Zero 
into an Altoids tin, the tin can actually hold six of 
them. (And yes, I’ve tried!) 


Size zero computer 

Along with my colleagues at Pi Towers, we’ve 
exploited the small size of Raspberry Pi Zero by 
putting them on our keychains, inside our wallets, 
and even sewing them onto our gloves. The small 
size allows you to hack existing products and 
squeeze a Raspberry Pi into them. It allows you 
to make Linux-powered wearables or build your 
own portable devices. With my Raspberry Pi Zero, 

1 created a portable, hackable GPS logger from 
off-the-shelf components. You can see how 1 made 
it on page 28. 

For those of you who consider yourself 
makers, I’m sure Raspberry Pi Zero will be a welcome 
addition to your toolkit. For the first time ever, 
a small, affordable and hand-solderable Raspberry Pi 
will be available to embed directly into your projects. 
And, of course, since it’s a Raspberry Pi you’ll have 
all the community support, tutorials and software 
available to make your project a reality. Since 
Raspberry Pi Zero has standard pitch solder pads for 
2-by-20 header pins, it can be easily soldered onto 
perfboard, or you can work with it in PCB design 
software like KiCad. What’s even more amazing is 
that you can actually download and run KiCad on 
the Raspberry Pi Zero itself. 

With the release of Raspberry Pi Zero, I’m 
glad that the cat is finally out of the bag and I’m 
incredibly eager to see what all of you do with it. 
Please don’t hesitate to share ideas and post your 
completed projects. If you’re not sure exactly what 
you want to do with it yet, here’s my suggestion: 
put it on your keyring, in your wallet, or keep 
it in your pocket so that you’ll be ready at any 
moment to show off how amazing it is to anyone 
who will listen. 
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Code Club is a nationwide network of volunteer-led after school clubs 
for children aged 9-11. 

We're always looking for people with coding skills to volunteer to run 
a club at their local primary school, library or community centre for an 
hour a week. 


You can team up with colleagues, a teacher will be there to support 
you and we provide all the materials you'll need to help get children 
excited about digital making. 


There are loads of ways to get involved! 

So to find out more, join us at www.codeclub.org.uk 


This advertising space was kindly donated to Code Club by MagPi Magazine 





FREE BONUS DAY! 






swfag.raspberrypi.org 




